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ABOUT THIS MANUAL 


GOALS OF THIS MANUAL 


The 4663 Interactive Digital Plotter Programmer's 
Reference Manual is for the programmer who is writing 
a package of computer subroutines that communicate 
with the TEKTRONIX 4669 Interactive Digital Plotter 
(hereafter refered to as “4663” or “Plotter’). This 
manual describes the Plotter commands and tells how 
to issue them by entering sequences of ASCII charac- 
ters at a compatible terminal or controller. 


This manual assumes the reader has a knowledge of 
programming fundamentals and terminology; it is not 
intended to be a tutorial of programming procedures. 


Rather, the manual provides instructions about how to 
control the Plotter using RS-232-C (Serial) communi- 
cations, General Purpose Interface Bus (GPIB) commu- 
nications, or by TEKTRONIX 4050 Series BASIC 
commands. This manual is written so that users with 
limited computer experience can learn to communicate 
with the Plotter. 


This manual is sequenced with two different colored 
tabs. Yellow tabs locate major areas of the manual 
while white tabs indicate command description 
sections. 


ORGANIZATION 


This manual is organized with the fundamental con- 
cepts and first-time operation in the first six sections; 
the remaining sections of the manual are devoted to 
groups of commands. Concepts relevant to the particu- 
lar command groups are included at the beginning of 
each command section. 


@ Section 1 (Introduction) describes the basic graphic 
concepts used with the Plotter. 


@ Section 2 (First-Time Operation Through the Serial 
Interface). 


® Section 3 (First-Time Operation Through the GPIB 
Interface). 
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@ Sections 4 and 5 (Serial Interface and GPIB Inter- 
face) provide an overview of specific programming 
needs for Serial or GPIB interfaces between the 
Plotter and the host/controller. lf you are already 
well acquainted with programming techniques, then 
you may wish to skip these sections and go directly 
to Section 6. 


@ Section 6 (Introduction to Commands and 
Arguments) describes the command syntax and 
conventions used in this manual and should be 
understood before going to the individual command 
sections. 


xiil 


@ Sections 7 through 16 (command description sec- While reading this manual, you may find it helpful to 
tions) provide specific information for different refer to the Appendices and the Index located at the 
groups of Plotter commands. Each command de- back of the manual. 


scription section begins with a discussion of the 


- ie ; 
major concepts relevant to the commands included Command Summary (Serial) — Appendix A 


in that section. The command description sections @ ASCII Code Chart — Appendix B 

are: @ Serial Interface Connector — Appendix C 

e Serial Interface Commands — Section 7 © Command Summary (GPIB) — Appendix D 

e GPIB Interface Commands — Section 8 © GPIB Description — Appendix E 

Device Commands — Section 9 ®@ Coordinate Conversion Chart — Appendix F 

¢ Alpha Commands — Section 10 ® Default Page, Viewport, and Window Coordinates — 
e Graphics Commands — Section 11 Appendix G 


e Transform Commands — Section 12 4662 Emulation Considerations — Appendix H 


e Digitizing Commands — Section 13 Plotter/4014 Command Capability — Appendix | 
e Macro Commands — Section 14 Error Types — Appendix J 


e Downloadable Character Commands — Section 
15 


e Media Advance Commands — Section 16 


Glossary — Appendix K 
Command Index — Appendix L 


Index — Located after the last appendix. 


OTHER 4663 MANUALS 


The following related manuals are available: © 4663 Interactive Digital Plotter Service Manual 
@ 4663 Interactive Digital Plotter Operator’s Manual (Volume 1) 
© 4663 Interactive Digital Plotter Reference Guide = ey Digital Plotter Service Manual (Vol- 


ad 
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SYNTAX 


The following summarizes the associated conventions 
and notations used throughout this manual. For more 
information, refer to Section 6, Introduction to Com- 
mands and Arguments. 


CHARACTERS 


ASCII Characters 


The 94 printing ASCII characters (numbers, symbols, 
and uppercase and lowercase letters) are represented 
by their normal symbols. 


The ASCII Control, SPACE, and DELETE characters are 
each represented by an appropriate single symbol. See 
the ASCII Code Chart appendix. 

NOTE 


The ASCII SPACE character is always shown as 
Sp, and not as a blank space between printed 
characters. 

Examples: &12ABab &c Sp 27 


The last three ASCII characters are ESCAPE, SPACE, 
and DELETE. 


Special Characters 


Two symbols are replaced by certain single ASCII 
characters. The two symbols, 47 and 4p, represent the 
attention and address characters, respectively, and are 
replaced as follows: 


At — attention character, replaceable by 
Ec! A or Sy 

An — address character, replaceable by 
ABCDEFGorH 
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LITERAL VS. VARIABLE ELEMENTS 


Boldface Type 


A literal element, which is entered exactly as shown, is 
shown in bold. 


Regular Type 


A variable element, which is replaced by appropriate 
specific information, is shown in regular type; a single 
element can be represented by one symbol, one word, 
or words connected by hyphens. 


Examples 


At Ap R rotation-angle 


where three elements are replaced and R is entered 
exactly as shown. 


!AR 45 


where five ASCII characters are entered exactly as 
shown. 


XV 


COMMAND ELEMENTS 


Element Types 


The last words of a 4663 Plotter variable element name 
indicates the element type required by the 4663, as 
shown below: 


Last Words Element Type 
selector selector 

string string 
print-string print string 

pa primary address 


target-variable target variable 
Other endings imply a numeric element. 
Examples: 

@ axis-selector is a selector element 

® print-character-string is a string element 


@ radius is a numeric element 


Omitted Numeric Elements 


When a numeric element is omitted, a value of zero is 
assumed. Any exceptions are noted where they occur. 


Argument Separators 


A nonbold comma (,) between elements can be re- 
placed by either a bold comma (,) or one or more Sp 
characters. A nonbold semicolon (;) between variable 
elements can be replaced by either a bold semicolon 
(;) or a bold comma (,). Exceptions are noted where 
they apply. 


Command Terminators 


Command terminators are generally NOT shown in the 
individual command descriptions. Specific termination 
varies with the interface and the Command/Response 

Format used. Refer to Sections 4 and 5 for instructions 
on how to terminate commands. 


xvi 


NOTATIONS 


Brackets [ ] 


An element inside brackets is optional. Stacked ele- 
ments within brackets indicate selection of one or none 
of the elements. 


Example: [0] 
[1] 


select O, 1, or neither 


Braces { } 


When multiple elements are stacked within braces, one 
element must be selected. 


Example: {0} 
{1} select O,1,or 2 
{2} 

Dots... 


Three dots (ellipsis) indicate that a previous element 
may be repeated. 


Example: Sp... one or more §p characters 


Indented for Continuation 


If acommand is continued on to the next printed line, 
the additional line is indented. 


Example: 41 4p X x-value,y-value[,x-value, 
y-value]. .. 
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Section 1 


INTRODUCTION 


This section describes some of the basic terminology 
and concepts fundamental to the 4663 Plotter graph- 
ics. These terms and concepts are used throughout 
this manual and should be understood before proceed- 


ing. 


Much of this overview applies to programmable com- 
mands, which are the focus of this manual. Some of 
these programmable operations (for example, the SET 
VIEWPORT command) are also available by using the 
front panel switches or Parameter Entry Card 
selections. Refer to the 4663 Interactive Digital Plotter 
Operator's Manual! for additional discussion of the front 
panel operations and for information concerning the 
physical parts of the Plotter. 


This section includes descriptions of the following: 


@ The Plotter 

® The Plotter Graphics System (General and Specific) 
® General Plotting Information 

@ Page Scaling 

@ Viewport Scaling 


Concepts for specific commands are included in the 
Command sections of this manual. 


THE PLOTTER 


The primary function of the Plotter (Figure 1-1) is to 
transfer graphic information onto media, such as paper 
or polyester film. This transfer is accomplished by 
commanding pens on the Plotter to draw lines and print 
alphanumeric characters. 


The commands associated with drawing lines are 
referred to as graphics commands. These include the 
fundamental MOVE and DRAW commands: 


@® MOVE—causes the pen to move to a specified 
position (but not to draw a line). 


@ DRAW—causes the pen to draw a line to a specified 
position. 


< lay Acch QI 
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Additional graphics commands include setup com- 
mands for establishing graphics parameters, com- 
mands to draw circles and arcs (requires Option 31), 
and commands for specific operations such as axis 
generation. 


Commands to print alphanumeric characters are re- 
ferred to as alpha commands and are discussed 
extensively in Section 10 of this manual. 


The 4663 digitizes points and sends those coordinates 
back to a host computer or terminal. Some graphics 
commands affect the digitizing function. 
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Figure 1-1. The 4663 Interactive Digital Plotter. 
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INTRODUCTION 


PLOTTER GRAPHICS SYSTEM—GENERAL 


The Plotter’s graphic system can be classified into two 
areas: the Plotter Domain and the User Domain. Some 
terms associated with these domains are defined here. 


In the Plotter Domain: 
@ Platen—The large flat surface on which the media is 


placed. 


@® Page—A rectangular area on the Platen that is used 
for plotting. 


@ Viewport—A rectangular area of the Page onto 
which the plot is drawn. 


In the User Domain: 


® World Space—The space associated with the object 
or picture. 


@ Window—A two-dimensional rectangular portion of 
the World Space which is projected onto the 
Viewport. 


The Plotter Domain and the User Domain each have 
coordinate systems and related units: 


®@ Device Coordinate System—The device (Plotter) 
dependent Cartesian coordinate system for the 
Page. 


® Device Units— Units for the Device Coordinate Sys- 
tem. 


@ World Coordinate System—A Cartesian coordinate 
system for the World Space. 


@ World Units—Units for the World Coordinate System. 
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In typical applications, represented by Figure 1-2, a 
portion of the World Space determined by the Window 
is plotted. The Window is set using World Units. The 
location of the plot is determined by the location of the 
Viewport. The Viewport is set using Device Units. Then 
graphics commands (MOVEs and DRAWS) are issued 
in terms of World Units and cause the Plotter to 
produce a plot within the Viewport. 


The typical application just described occurs when the 
Graphic Units selection is the default selection of 
World Units. One other Graphic Units selection, called 
Device Units, is available. With Device Units selected, 
graphics commands are issued directly in terms of 
Device Units. Coordinates for MOVE and DRAW com- 
mands are referenced to the Page and are not affected 
by Window and Viewport settings. 


The Plotter allows three types of Device Units: 


@ Addressable Device Units (ADUs) 
®@ Graphic Device Units (GDUs) 


@ Millimeters (mm) 


ADUs are used with Serial devices, such as the 
TEKTRONIX 4010 Series terminals; GDUs are used 
with GPIB devices, such as the TEKTRONIX 4050 
Series Graphic Systems. The mm selection provides an 
additional set of Device Units to relate actual physical 
size of millimeters. 


Displaying graphics on the Plotter is very similar to 
displaying graphics on the screens of display devices. 
At power-up, the Plotter automatically selects the type 
of units that correspond to your installed interface. 
Thus, the 4663 allows you to use the same numbering 
system on the Plotter as you are using on your display 
device. 
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Figure 1-2. The Plotter’s Graphics System. 
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INTRODUCTION 


PLOTTER GRAPHICS SYSTEM—SPECIFIC 


The following description of the Plotter Graphics 
System is separated into two topics—Pilotter Domain 
and User Domain. Additional general plotting informa- 
tion is provided later in this section. 


PLOTTER DOMAIN 


The Plotter Domain discussion covers the following 
parts of the Plotter: Pen Carriage, Platen, Platen 
Clipping Boundary, Page, Viewport, the Device 
Coordinate System, and Device Units. 


Pen Carriage 


The Pen Carriage consists of three parts—two pen 
holders and a crosshair cursor. Since any of these 
three parts may be physically positioned over the 
media at a point specified by plotting coordinates, this 
manual uses the generic term pen carriage unless it is 
necessary to specifically identify one of the pens or the 
crosshair cursor. 


The front panel Pen Control switches and the 

SELECT PEN command select either of the pens (Pen 1 
or Pen 2) or the crosshair cursor to be at the location 
specified by the plotting coordinates. For plotting, the 
selected pen moves to positions set by the plotting 
coordinates. When neither pen is in position, the 
crosshair cursor indicates the position specified by the 
plotting coordinates. 


Platen and Platen Clipping Boundary 


The platen is the large flat surface of the 4663 Plotter 
onto which the media is placed. The maximum area on 
the platen that is available for plotting is outlined by the 
Platen Clipping Boundary. Both pens have access to 
this area. See Figure 1-3. 
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Page 


The Page is a rectangular area on the platen which can 
be used for plotting. The Page provides a plotting area 
(or viewing area) similar to the full screen on a terminal. 
Usually the Page size corresponds to the size of the 
media in use. 


The operator may select one of 12 pre-defined Initial 
Page sizes which conform to standard media sizes. 
These 12 sizes are selected using the Initial Page Size 
and Inital Page Format lines on the Parameter Entry 
Card, as described in the 4663 Operator's Manual. 
Normally, the media has margins extending beyond the 
Page boundaries. The Page boundary is shown in 
Figure 1-4. 


Pages may also be established by the operator using 
front panel Set Page functions. One such user-defined 
Page may be saved by using the SAVE USER DEFINED 
selection on the Initial Page Size line of the Parameter 
Entry Card. Pages may not be set by the host, but the 
host can issue the DEVICE RESET (3) command to 
reset the Page to the Initial Page established by the 
current Parameter Entry Card selections. The selec- 
tions which establish the Initial Page include the 
following lines: Media Form, Initial Page Size, Initial 
Page Format, Page Orientation, and Initial Aspect Ratio. 


Pre-defined or user-defined Pages may extend outside 
the Platen Clipping Boundary. The portion of the plot 
within the Platen Clipping Boundary is drawn; the 
portion outside the boundary is not drawn. 
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Figure 1-3. Platen and Platen Clipping Boundary. 
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The 4663 Operator’s Manual describes other capabili- 
ties associated with setting Pages from the front panel 
switches and Parameter Entry Card. One of these 
involves choosing VERTICAL or HORIZONTAL orienta- 
tion on the Page Orientation line of the Parameter Entry 
card. With HORIZONTAL orientation, the horizontal axis 
(X-axis) is parallel to the media guide. With VERTICAL 
orientation, the Y-axis is parallel to the media guide. 


PAGE BOUNDARY 








INTRODUCTION 


Another capability involves Page reversals. The 
LOWER LEFT and UPPER RIGHT switches on the front 
panel are used to set the physical upper-right corner to 
be down and/or to the left of the physical lower-left 
corner. Procedures are included in the "Getting Start- 
ed” section of the 4663 Operator's Manual which 
describe these operations. 
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Figure 1-4. Page, Media, and Platen (Shown for C-Size Media, Drafting Boundaries, and Sheet Mode). 
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INTRODUCTION 


Device Coordinate System and Device 
Units 


The Device Coordinate System is a Cartesian 
coordinate system for the Page. The origin (0,0) of the 
coordinate system is the lower-left corner of the 
designated Page. The physical lower-left corner may 
be at any corner because of Page orientation and Page 
reversal situations mentioned earlier. 


Three Device Coordinate Systems exist for three types 
of Device Units: 


@ Addressable Device Units (ADUs) 
® Graphic Device Units (GDUs) 
@ Millimeters (mm) 


The default Device Unit selections are interface depen- 
dent. When using a Serial interface, ADUs are the 
default Device Unit; GDUs are the default Device Unit 
when the Plotter is attached to the controller through a 
GPIB interface. Default Device Units occur at power-up 
or after the DEVICE RESET, SELECT COM- 
MAND/RESPONSE FORMAT, or INTERFACE 
PARAMETER RESET commands are issued. However, 
either ADUs, GDUs, or millimeters can be selected as 
the Device Unit by the SELECT DEVICE UNITS com- 
mand. 


The ranges for each of the three types of Device Units 
are based on the aspect ratio of the Initial Page and are 
established so that they are the same physical length 
in the horizontal and vertical directions. These ranges 
are as follows: 


e@ ADUs—0O to 4096 on the larger (usually horizontal) 
Page axis and from 0 to a proportionally smaller 
number on the second axis. 


@ GDUs—0 to 100 on the shorter (usually vertical) 
Page axis and from 0 to a proportionally larger 
number on the second axis. 


@ Millimeters (mm)—O to the actual physical length for 
each axis of the Initial Page. 
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These ranges are not changed when the Page is 
changed by front panel Set Page operations. However, 
Set Page operations can change the physical length of 
the Device Units and make them unequal for each axis. 
If this occurs, a Subsequent DEVICE RESET (0 or 1) 
command or a SAVE USER DEFINED selection on the 
Parameter Entry Card establishes new Device Unit 
ranges according to the above rules for the revised 
Page. 


Viewport 


The Viewport is the rectangular area of the Page onto 
which the plot is drawn. Viewport boundaries are 
always on or within the Page boundaries. Coordinates 
for the Viewport are expressed in Device Units. 


Viewports are specified or directly set in three ways: 


@ Using the Initial Aspect Ratio line on the Parameter 
Entry Card (this also re-establishes the Initial Page). 


@ Issuing the SET VIEWPORT command. 
@ Using the front panel Set Viewport function. 


As with Page reversals, Viewports can be Set to have 
the upper-right corner physically or numerically lower 
and/or to the left of the lower-left corner. 


The Plotter’s default or Initial Viewport is established in 
one of three ways: at power-up; when the Plotter 
receives the DEVICE RESET (0, 1, or 3) command; or 
when new Selections are made on the Parameter Entry 
Card lines Media Form, Initial Page Size, Initial Page 
Format, Page Orientation, or Initial Aspect Ratio. 


The Initial Viewport depends on the Initial Aspect Ratio 
selection on the Parameter Entry Card. The Initial 
Viewport and Initial Page lower-left corners are at the 
same location, and the Viewport fills as much of the 
Page as the initial Aspect Ratio line setting allows. With 
FULL PAGE selected on the Initial Aspect Ratio line, 
the Initial Viewport and the Initial Page are identical. 


Changes and distortions in the Page as a result of front 


panel Set Page operations cause proportional physical, 
but not numerical, changes in the Viewport. 
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USER DOMAIN 


The User Domain includes the World Space, the World 
Coordinate System and World Units, the Window, and 
transformation-of-data capability. 


World Space 


The World Space is the space associated with an 
object or picture. World Space can contain graphs, 
maps, physical objects, mechanical drawings, or other 
pictures. 


World Coordinate System and World Units 


The World Coordinate System is a Cartesian coordi- 
nate system for World Space. World Units are used 
with the World Coordinate System. In general, World 
Units are established for the picture or object to be 
displayed and can be dimensional in any unit of 
measure, such as gallons, seconds, dollars, light years. 


A default set of World Units is established at power-up 
or when the DEVICE RESET (0, 1, or 3) command is 
issued. The default set is either ADUs when using the 
Serial interface or GDUs when using the GPIB inter- 
face. 


NOTE 


The ADUs or GDUs for the World Coordinate 
System can be of different lengths than the ADUs 
or GDUs for the Device Coordinate System. This 
is discussed in the next subsection. 


In addition, a default set of World Units is established 
for selections on any of the five Parameter Entry Card 
lines labeled: Media Form, Initial Page Size, Initial Page 
Format, Page Orientation, and Initial Aspect Ratio. The 
default set corresponds to the existing Device Units 
selection, which may include millimeters in addition to 
ADUs and GDUs. 
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Window 


The Window is a rectangular portion of the World 
Space that is projected onto the Viewport. The 
Window is set using World Units. It does not change 
when the SET VIEWPORT command is issued or with 
front panel Set Viewport and Set Page functions. 


The SET WINDOW command can be used to assign 
appropriate coordinates to the Window. For example, 
the SET WINDOW command might be used to match 
the Window coordinates to a graph with units of inches, 
miles, gallons, etc. The units and range for each axis 
would be different. For example, the range on one axis 
may be from 5 to 10 gallons and 85 to 105 seconds on 
the other. 


Unlike Pages and Viewports, the Window coordinates 
cannot be defined so that the lower-left corner is 
numerically larger than the upper-right corner. How- 
ever, selections on the Initial Axis Orientation line of 
the Parameter Entry Card other than the left-most 
selection (X-axis horizontal pointed right and Y-axis 
vertical pointed up) provide axis reversals and inter- 
changes. 


Initial Windows exist for each of the three Device Units 
selections of ADUs, GDUs, and millimeters. If the 
Device Units selection is changed, the Initial Window is 
set by the rules for the new Device Units selection. 


NOTE 


The range of Initial Window values is determined 
by the Initial Viewport dimensions as opposed to 
the Initial Page dimensions of the device. The 
Initial Aspect Ratio line on the Parameter Entry 
Card has selections that allow the Initial Viewport 
to be different than the Initial Page. The Viewport 
and Page are the same when FULL PAGE is 
selected on the Initial Aspect Ratio line. With 
other selections, the physical lengths of ADUs 
and GDUs for default World Units may be different 
than ADUs and GDUs for Device Units. 
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INTRODUCTION 


The numerical ranges for each Initial Window are 
established so that the World Units are the same 
physical lengths on the horizontal and vertical axes. 
The 0,0 location is projected on the Initial Viewport 
lower-left corner. The ranges are as follows: 


@ ADUs—O to 4096 on the longer Initial Viewport axis 
and from 0 to a proportionally smaller number on the 
second axis. 


@ GDUs—0O to 100 on the shorter Initial Viewport axis 
and from 0 to a larger number on the second axis. 


@ Millimeters (mm)—O to the actual physical lengths 
for each axis of the Initial Viewport. 


These Initial Window ranges are established so that the 
Plotter appears similar to other display devices such as 
the TEKTRONIX 4010 Series for ADUs and the TEK- 
TRONIX 4050 Series for GDUs. In fact, the Initial 
Window using the default World Units may match other 
devices closer than the Initial Page using the default 
Device Units because the Initial Window is based on 
the Initial Aspect Ratio selection on the Parameter 
Entry Card. For example, a 4X:3Y (actually 4096X: 
3124Y) selection provides an Initial Window that 
matches the screen coordinates of a TEKTRONIX 4014 
terminal, regardiess of the Initial Page. 


The Initial Window is important in providing units for 
specifying alphanumeric character size and spacing 
and dash pattern length, even though the actual 
Window can be different from the Initial Window. 


Any selection other than the left-most selection on the 
Initial Axis Orientation line of the Parameter Entry Card 
changes the 0,0 location and/or the direction of the X- 
and Y-axes. However, the rules above still apply to 
determine the axis ranges for these cases. 


Transformations 


User data describing the picture or object can be 
modified by using transformations. The available trans- 
forms allow scaling, rotation, translation, skewing, and 
other special purpose operations. See Section 12, 
Transform Commands, for details. 


Transforms are cleared on power-up, or through any 


other operation that redefines or resets the Window or 
Viewport. 
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GENERAL PLOTTING INFORMATION 


GRAPHIC UNITS 


Graphic Units, which may be either World Units or 
Device Units, are selected by the SELECT GRAPHIC 
UNITS command to establish the coordinate system for 
subsequent MOVE and DRAW commands. The SELECT 
GRAPHIC UNITS command is also used to 
independently select Graphic Units for digitizing (dis- 
cussed shortly). 


The default Graphic Units selection is World Units, 
which occurs at power-up or when the DEVICE RESET 
command is issued. When World Units are selected, 
the data is modified as a result of any transforms that 
have been entered. When Device Units are selected, 
the coordinates for MOVEs and DRAWS are referenced 
to the Page and are not affected by transforms or 
Window and Viewport settings. 


COORDINATE TYPE 


MOVE and DRAW commands can be specified using 
relative or absolute coordinates as determined by the 
SELECT COORDINATE TYPE command. Absolute 
coordinates are referenced to the current coordinate 
system. Relative coordinates are referenced to the 
current pen carriage position and are entered in terms 
of displacement in the X- and Y-directions from the 
current pen carriage position. 


The default selection is absolute coordinates. This 
occurs on power-up, and after the DEVICE RESET 
command. 


LINE TYPE 


The SELECT LINE TYPE command can be used to 
select solid, fixed dash-pattern-length, variable dash- 
pattern-length, and point line types for drawing opera- 
tions. Line type selections other than solid are avail- 
able only when the Graphic Units selection is Worid 
Units. The default line type is solid line and occurs at 
power-up and when the DEVICE RESET command is 
issued. 


4663 PROGRAMMER’S REFERENCE 


Some operations, such as axis generation and the 
printing of alphanumeric characters, use solid lines 
regardless of the line type selection. More information 
about line types and related commands is contained in 
the Graphics Commands section. 


CLIPPING 


Clipping refers to the process by which the portion of a 
plot that falls outside of a clipping boundary is not 
plotted. This process does not distort the portion of the 
plot within the clipping boundary. When the pen is 
commanded to draw to a position outside the boundary, 
it draws only to the intercept point at the boundary. 
When commanded to draw from a position outside the 
boundary to a position within, the pen begins drawing 
at the intercept point of the new line and boundary. 


There are two active clipping boundaries: the Platen 
Clipping Boundary and either the Page Clipping 
Boundary or the Viewport Clipping Boundary. The 
Platen Clipping Boundary outlines the maximum area 
accessible by the pen carriage. The Page Clipping 
Boundary outlines the edges of the Page. The Viewport 
Clipping Boundary outlines the Viewport edges. The 
SELECT CLIPPING CONTROL command is used to 
select either Page or Viewport Clipping Boundaries. 


Normally, the Page and Viewport are inside the Platen 
Clipping Boundary. However, if an edge of an active 
Page or Viewport Clipping Boundary is outside, then 
clipping occurs at the corresponding edge of the Platen 
Clipping Boundary. 


The clipping contro! of the SELECT CLIPPING CON- 
TROL command selection is independent of the Graph- 
ic Units selection. For example, MOVEs and DRAWs 
can be specified using Device Units, but clipping 
occurs at the Viewport boundary. Similarly, clipping 
can occur at the Page boundaries even when World 
Units are specified. 


The default clipping control selection is at the Viewport 
Clipping boundary and occurs at power-up and after 
the DEVICE RESET (0, 1, or 3) command is issued. 


INTRODUCTION 


DIGITIZING 


In addition to plotting, the 4663 Plotter can also be 
used for digitizing (also referred to as graphic input); 
that is, it can send coordinates to the host. 


NOTE 


Coordinates for digitizing are always absolute, 
regardless of the coordinate type selection of the 
SELECT COORDINATE TYPE command. 


The SELECT GRAPHIC UNITS command provides a 
digitization selection. When Device Units are selected, 
coordinates are reported to the host in terms of the 
Device Coordinate System and using the current 
Device Units (ADUs, GDUs, or mm). When World Units 
are selected, the current Window, Viewport, and trans- 
forms all affect the response so that coordinates are 
reported in World Units. The Graphic Units selection 
for digitization can be different than the selection for 
commanded MOVEs and DRAWS. For example, the 
selection for MOVEs and DRAWSs can be World Units 
while the digitization selection is Device Units. 


Points digitized using Device Units are restricted to be 
within the Page boundaries. Coordinates lying outside 
are interpreted by the Plotter as being on the nearest 
Page boundary. An exception to this occurs when the 
Page Orientation line on the Parameter Entry Card is 
set to VERTICAL. For this special case, the actual 
coordinates are reported even if they are outside the 
Page boundaries. 
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The default Graphic Units for digitizing is World Units. 
This occurs on power-up and when the DEVICE RESET 
command is issued. 


Several methods to digitize points are discussed in 
Section 13 and also in the READ STATUS command 
description. 


DATA RESOLUTION 


The maximum resolution between points on the Plotter 
1s .001 in (0.0254 mm). Real numbers that imply 
greater resolution can be handled by the Plotter’s 
internal software. However, the positioning of the pen 
and the reporting of manually located coordinate 
positions are limited to the maximum resolution. 


ERROR REPORTING 


The 4663 Plotter reports the occurrence of errors by 
displaying a flashing or steady Reset light and sound- 
ing the bell. Lights on the Parameter Entry Module can 
be interpreted as an error number to determine the 
source of the error. Appendix J tabulates the error 
numbers and error sources. 


Procedures to read the error information provided by 
the Paramater Entry Module lights are given in the 
4663 Operator's Manual and in this manual under the 
description of the READ ERROR command. 
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PAGE SCALING 
For some applications, the physical length of the ADU This same Page has 100 GDUs along its shortest axis 
or GDU must be known. In general, this can be found by of 15.5 in (393.70 mm). Its Page scaling is: 
looking up or measuring the length of each axis and 
dividing by the number of Device Units. Appendix G 15.5 in = 155 in/GDU or 6.45 GDUs/in 
includes tables listing the ranges for default Page 100 GDUs 
sizes. An example is provided here for determining or 
Page scaling. 393.70 mM — 3.937 mm/GDU or .254 GDUs/mm 
100 GDUs 
A C-sized, drafting Page has 4096 ADUs along its 
longest axis of 21 in (533.40 mm). Therefore the Page Other Page scaling can be calculated in a similar 
scaling is: manner. 
_21iN = (90513 in/ADU or 195.05 ADUs/in 
4096 ADUs 
or 
533.40 mM — 43022 mm/ADU or 7.68 ADUs/mm 
4096 ADUs 
VIEWPORT SCALING 
Viewport scaling is done in a manner similar to Page For GDUs the shortest axis is 15.5 in times 3124/4096 
scaling. Default Viewport dimensions are also given in which equals 11.82 in (300.27mm) or 100 GDUs. The 
Appendix G. Viewport scaling is: 
For example, a C-sized, drafting Page with initial aspect 11.82in | 4482 in/GDU or 8.459 GDUs/in 
ratio of 3X:4Y (3124X:4096Y) is considered. In ADUs, 100 GDUs 
its longest axis is 15.5 in (393.70 mm), which corre- or 
sponds to 4096 ADUs. The Viewport scaling is: 300.27 MM — 30027 mm/GDU or .3330 GDUs/mm 
; 100 GDUs 
155iN = 00378 in/ADU or 264.3 ADUs/in 
4096 ADUs 


or 
393.70 MM — 09961 mm/ADU or 10.04 ADUs/mm 
4096 ADUs 
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Section 2 


FIRST-TIME OPERATION 
THROUGH THE SERIAL INTERFACE 


NOTE 


If using a GPIB interface, skip to Section 3, First-Time Operation Through the GPIB Interface. 


INTRODUCTION 


The procedures offered in this section provide the 
opportunity to experience many of the command 
sequences firsthand, thereby demonstrating the Plot- 
ter’s actions in response to various commands. This 
familiarization procedure does not describe all com- 
mands or sequences of commands, but instead pro- 
vides a general overview of Plotter operation. 


It is assumed that the reader is already familiar with the 
information contained in the Getting Started section of 
the 4663 Operator’s Manual. That section includes 

) media and pen loading instructions and gives an 
introduction to the Plotter’s front panel controls and 
indicators. 


The conventions used in this section, and throughout 
the manual, are described in detail in Section 6, 
Introduction to Commands and Arguments. For your 
convenience, a few of the more common conventions 
are discussed here: 


®@ The attention character (4), which is the first 
character in each command of this procedure, is the 
exclamation point (!). If necessary, you can select 
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any of the three following characters to be the 
attention character: ®c, A, or Sy. To change the 
attention character, change the selection on the 
Attention Character line of the Parameter Entry Card 
and then use €c, A, or Sy instead of ‘‘!’’. (Fe and Sy 
are shown as ESC and SYN, respectively, on the 
Parameter Entry Card. 


Characters shown in bold type must be transmitted 
exactly as shown. 


When communicating with the Plotter, the host 
should only transmit space characters indicated by 
Sp, Spaces between command characters are 
included to improve readability of the text and 
should not be interpreted as space characters. 


Cr stands for Carriage Return (or Return). 


NOTE 


Paper media and fiber-tip pens must be installed 
before performing these procedures. Refer to the 
4663 Operator's Manual for media and pen 
loading instructions. 


FIRST TIME — SERIAL 


PROCEDURE 


The following procedure assumes C-size media is 
installed. 


1. Connect the Plotter to the terminal. 


a. 


Check that only the paper media is on the 
platen. All other materials should be removed. 


Turn off the Plotter (if not off already). 


Attach a terminal, such as a TEKTRONIX 4010 
Series, 4006-1, to the Serial port on the rear 
panel of the Plotter marked TERMINAL. 


Turn on both the Plotter and the terminal, and 
initialize the terminal, if necessary. (After a few 
seconds, press the PAGE or ERASE key on the 
TEKTRONIX terminal to erase the screen.) All 
familiarization commands will be issued from 
the terminal keyboard. 


Set the terminal as follows: 


(1) Baud rates (transmit and receive) — 300 
baud recommended for this procedure. 


(2) Echo — local. 


(3) If a TEKTRONIX 4024, 4025, or 4027 
terminal is used, do not establish a Work- 
space; use Monitor mode. Also, select 
COMMAND LOCK OUT. 


2. Set the Plotter’s front panel switches. 


a. 


Set the following Plotter front panel switches 
(others should be ignored): 


(1) INTERFACE switches to ONLINE LOCAL 
(see Figure 2-1). 


(2) Select either PEN 1 OR PEN 2 with the 
appropriate SELECT switch in the Pen 
Control group. 


3. Make Parameter Entry Card selections as follows: 


NOTE 


Push the Parameter Entry Card fully into the 
Plotter before making any selections. 


NOTE 


For this procedure, you need make selections 
only for the Parameter Entry Card lines listed 


here. 


a. 


Parameter Setup Select — SETUP 1. (If the 
INIT light on the Parameter Entry Module is 
ON, momentarily push the Parameter Entry 
Card fully in before resuming this procedure.) 


INTERFACE 


O OFFLINE 
® ON LINE 


om toler VE 
#® REMOTE 


Figure 2-1. INTERFACE Switches Set to ONLINE/LOCAL. 
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FIRST TIME — SERIAL 


b. Media Form — SHEET. (Set to ROLL if the d._ Initial Page Format — DRAFTING. 
Media Advance Option is installed and roll e. Page Orientation — HORIZONTAL. 


media is being used.) 
: iti io — L E. 
6. initial Pape Sze — C. f. Initial Aspect Ratio — FULL PAG 


= g. Initial Axis Orientation — Select leftmost col- 
NOTE umn. 
You can select any of the other pre-defined sizes h. Line Quality — PREVIEW. 


(B, A, A2, A3, or A4) on this line and you can 


sg select the other format (GRAPHING) on the next Pome alalvett seeds = PENA 
line. If you select a new combination, you may 
observe a Slight difference between the plotted 

- results and those shown in Figure 2-2. 
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Figure 2-2. Plot Produced by Section 2 Procedures. 
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FIRST TIME — SERIAL 


j. 


Pen Type — FIBER TIP. 


NOTE 


To set the Pen Type for Pen 2, select PEN 2 on 
the Pen Parameter Access line, and then make 
the FIBER TIP selection on the Pen Type line. The 
next two lines, Pen Pressure and Pen Velocity 
Limit, are set automatically. 


kK. 


Alpha Character Quality — NORMAL. 


Interface Select — 1. (If the Interface Select 
line selection is changed, it is necessary to 
momentarily push the Parameter Entry Card 
fully in before resuming.) 


Initial Command/Response Format — 2. 


NOTE 


The next three lines, GPIB Device Address, Inter- 
face Mode, and Interface Functions, are for use 
only with the GPIB interface and need not be set 


at this time. 

n. Serial Device Address — A. 

o. Receive Baud Rate - 300 baud recommended 
for this procedure. (Selected baud rate must 
match baud rate set on the terminal.) 

p. Transmit Baud Rate — 300 baud 
recommended for this procedure. (Selected 
baud rate must match baud rate set on the 
terminal.) 

q. Transmit Baud Rate Limit — FULL SPEED. 

r. Character Format — 8 DATA BITS/CHAR and 1 
STOP BITS. (Make two selections.) 

s. Receive Parity/Transmit Parity — 


IGNORE/LOGIC 0. 


Communications Control Mode — FULL DU- 
PLEX. 


NOTE 


It is not necessary to make a selection on the 
DC1/DC3 Control line at this time. 
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u. 


Interface Functions — CR GENERATES LF. 
(Press either switch.) 


Attention Character — ! 
Output Terminator — NONE. 


Push the Parameter Entry Card back into the 
Plotter. No other selections are required at this 
time. 


4. Execute the following samples of Plotter com- 


mands. 


NOTE 
In this manual, the ASCII Space character is 


always represented by Sp. The use of spacing 


within command descriptions is for clarity of 


presentation only. Do not send a space character 
in place of spacing. The following example con- 


tains two space characters: 


!A “P ThreeSpwordSpexample” Sr 


a. Issue the PLOTTER ON command: 
IAECr 


This command causes the Plotter to execute 
subsequent commands. 


b. Move the pen carriage to a point near the 
upper-left corner of the Page: 


!A AH Cr 
c. Type the following text and note that the 
characters (upper and lowercase) are printed 


(some terminals are restricted to uppercase 
characters only): 


46635pInteractivespDigitalSpPlotter 
Sp(Serial)°r 


d. Transmit the following MOVE command to 
move the pen carriage to a point near the 
center of the Page: 


1A X 2050,1500 Sr 


e. To draw a horizontal vector from this point, 
send a DRAW command: 


!A Y 3000,1500 ©r 


f. To move two character spaces to the right and 
down one line space, type a CHARACTER 
MOVE command: 


!A AM 2,—1 Sr 

Draw Dashed Line Vectors. 

a. Transmit a SET DASH PATTERN command: 
!A BD 2,3 Cr 


This determines the proportion of blank line to 
drawn line. 


b. Establish a dash pattern length of 300 ADUs 
using the SET DASH PATTERN LENGTH com- 
mand: 


!A BS 300 Cr 
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c. Transmit a SELECT LINE TYPE command to 
establish a fixed dash-pattern-length line type 
selection: 


!A BL 1 Cr 


d. Issue a DRAW command to cause the Plotter to 
draw a dashed line from the current pen 
carriage position to the point determined by 
the command coordinates: 


1A Y 4000,300 Cr 


e. To reset the Plotter to solid line type, transmit a 
SELECT LINE TYPE command: 


!A BLO Cr 


6. Change the Font Selection. 


a. Transmit a MOVE command to position the pen 
on the left edge and down from the top: 


1A X 0,2500 Sr 


b. Type as many of the following characters, 
shown for Font O, as your terminal permits and 
notice that they are printed as shown for Font 
O in Figure 2-3. 


#I\}{|} or 


c. To select Font 2, transmit a SELECT STAN- 
DARD ALPHA FONT command: 


IAT 2¢r 


ronto: #0£\I{|} 


FONT 2: EAOUGSU 





Figure 2-3. Fonts O and 2. 
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d. Type as many of the following characters, 
shown for Font 0, as your terminal permits and 
notice that printed characters appear as 
shown for Font 2 in Figure 2-3: 


#I\]{|} or 

e. Set the aloha parameters back to default: 
IAVCR 

Change the printed character size. 


a. Transmit a MOVE command to position the pen 
to the left edge and down from the top: 


!A X 0,2000 Sr 
b. Type the following characters: 
ABC 


c. The size of the alphanumeric printing can be 
changed by transmitting an ALPHA SIZE com- 
mand: 


!A BZ 112,161 Sr 
d. Type the following characters: 
ABC Cr 
The printed characters are about three times 
as large as they were for Step 7b. 
e. Set the alpha parameters back to default: 
IA VCR 
Change the alpha ratio. 
a. Type the following: 
ABC Cr 
DEF Cr 
b. Change the alpha ratio: 
!A BI 3,3.27 &r 
c. Once again type the following characters: 


ABC Cr 
DEF °r 


The Plotter should print characters of the same 
size, but with a distance from the origin of one 
character to the origin of the next character of 
twice the default distance; the distance from 
the baseline of one Jine of printing to the 
baseline of the next line of printing is about 
twice the default distance. 


d. Reset the alpha parameters to their default 
values: 


1A V Sr 


FIRST TIME — SERIAL 


103. 
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Change the alpha scaling factors. 
a. Type the following characters: 
ABC 


b. To alter the X and Y multiplication factors for 
Alpha characters, transmit a SET ALPHA 
SCALE command: 


!A BH 3,2 &r 
c Type the following: 
ABC 


Notice that the characters and character-to- 
character spacings are three times as wide 
and three times as high as they were before 
the SET ALPHA SCALE command in Step 9b. 


d. Toreset to the scaling factors, to the default 
condition, transmit a SET ALPHA SCALE com- 
mand with magnification factors 1,1: 


!A BH 1,1 Sr 
e. Type the following: 
ABC Cr 


Notice that the characters are printed with 
default size and spacing. 


Print characters on a diagonal line. 


a. Move the pen carriage to a point above the 
center of the media: 


!AX 2000,2000 Cr 


b. To set the printing angle (and the left margin), 
transmit a SET ALPHA ROTATION command: 


1A J 45 Sr 
c. Type the following: 
ABC 


The characters are printed on a line rotated 
45° from horizontal. 


qd. Aright margin is established by transmitting a 
SET ALPHA MARGIN SEPARATION command: 


1A BR 10 Sr 


Ut 


e. Continue to type the alphabet (D,E, F,....) and 
notice that after the 10th character has been 
typed on a line, the Plotter automatically 
executes a CARRIAGE RETURN (€r) and a 
LINE FEED (te) to continue printing on the next 
line. Also, notice that both margins (left and 
right) are perpendicular to the printing direc- 
tion (which in this case is at a 45° angle). 


Change the slant of the printed characters. 


a. Slanted characters can be printed by transmit- 
ting a SET ALPHA SLANT command: 


1A BG 20 &r 
b. Type the following: 
ABC Cr 


Notice that these characters, although printed 
along the 45° angle printing direction are, in 
addition, slanted to the right 20°. 


c. Reset the alpha parameters: 
IAVCR 


. Sample Transform commands. 


To illustrate some of the Transform commands, 
first draw a Square box and then modify it with 
Transform commands. 


a. Transmit a MOVE command to position the pen 
carriage at the lower-left corner of the box: 


1A X 500,0 Cn 


b. To draw the box, transmit the following DRAW 
commands: 


!A Y 1000,0 ©r 

!A Y 1000,500 Sr 
'A Y 500,500 ©r 
!A Y 500,0 Cr 


A box with 500 ADU sides will be drawn with 
its lower-left corner 500 ADUs to the right of 
the Viewport origin. 


To save the present (default) transform, 
transmit a SAVE CURRENT TRANSFORM com- 
mand: 


1A AX Cr 


Ga 
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a. 


To change the X-Y scaling factors for subse- 
quent graphing, transmit a SET SCALE com- 
mand: 


!A AS 2,3 Cr 


Retransmit the commands in Steps 12a and 
12b. Notice that this box is twice as wide and 
three times as high as the first box and is 
displaced to the immediate right of the first 
box. The lower-left corner of both boxes is 
500,0, but 500 on the X-axis, after rescaling, is 
twice as far from the origin as it was when the 
first box was drawn. 


To restore the default transform matrix and 
delete the scaled transform matrix from RAM 
storage, transmit a RESTORE PREVIOUS 
TRANSFORM command: 


1A AY Sr 


. Rotate the picture. 


Transmit the SAVE CURRENT TRANSFORM 
command to save the present (default) trans- 
form matrix: 


1A AX Sr 


To rotate the axes of the Viewport 40°, transmit 
a SET ROTATION command: 


1A AR 40 Sr 


Then retransmit the commands in Steps 12a 
and 12b. Notice that the box is re-drawn 
rotated counterclockwise by 40°. 


To restore the default transform matrix and 
delete the current transform matrix, transmit a 
RESTORE PREVIOUS TRANSFORM command: 


1A AY Sr 


14. Establish a new Viewport. 


a. 


To mark the Initial Viewport, transmit a MARK 
VIEWPORT command: 


1A CM Sr 
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b. To set the Viewport (without using the front 
panel controls or the Paramenter Entry Card), 
transmit a SET VIEWPORT command: 


!A AV 2050,4050,50,1 450 Sr 


c. Tooutline this new Viewport, transmit an 
OUTLINE VIEWPORT command: 


!A CB Sr 


d. Redraw the box using the commands in Steps 
12a and 1 2b. Notice that the box and the 
Viewport outline in Step 13c are reduced in 
size proportionately. 


e. Torestore the Initial Viewport, pull the Parame- 
ter Entry Card out to the Initial Page Size line 
and press the switch over C. 


NOTE 


Even though that switch’s light will still be on, you 
must press the switch at this time. The Viewport 
size then becomes the same as the Initial Page 
size. 


15. Disable one axis of the Joystick. 


This command could be used, for example, to 
digitize the Y-coordinates of a graph at a known X- 
axis location. 


a. Todisable the X-axis of the Joystick, transmit 
a JOYSTICK DISABLE command, specifying 
the X-axis: 


!A BJ 1 Cr 


b. Move the Joystick around and notice that it 
only causes the pen to move along the Y-axis. 


c. Both axes of the Joystick are again enabled 
any time the host repositions the pen or 
another JOYSTICK DISABLE command is giv- 
en, specifying that neither axis be disabled. 
Enter: 


!A BJO Cr 
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FIRST TIME — SERIAL 


16. Obtain digitized pen carriage coordinates. 


a. 


Pull the Parameter Entry Card out to the Initial 
Command/Response Format line and press the 
switch above “2”. 


Position the pen near the center of the 
Viewport: 


!AX 2000,1500 Cr 


To display the pen carriage coordinates (in 
ADUs) on the terminal screen, transmit a 
DIGITIZE command: 


1AM SR 


Notice that the first two of three numbers, 
written in scientific notation, indicate the X- 
and Y-coordinates, respectively, of the MOVE 
command in Step 16b. 


d. Use the Joystick to move the pen carriage. 
Then transmit another DIGITIZE command: 


IAM Cr 


The new pen coordinates will be printed on the 
terminal screen. 


This completes the familiarization procedure for the 
Serial interface commands. 
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Section 3 


FIRST-TIME OPERATION 
THROUGH THE GPIB INTERFACE 


NOTE 


If you are using a Serial interface, refer to Section 2, First-Time Operation Through the Serial Interface. 


INTRODUCTION 


The procedures offered in this section provide the 
opportunity to experience many of the command 
sequences first-hand, thereby demonstrating the Plot- 
ter’s actions in response to various commands. This 
familiarization procedure does not describe all com- 
mands or sequences of commands, but instead pro- 
vides a general overview of Plotter operation. 


It is assumed that the reader is familiar with the 
information contained in the Getting Started section of 
the 4663 Operator’s Manual. Getting Started includes 
media and pen loading instructions and gives hands-on 
instruction for the Plotter’s front panel controls and 
indicators. 
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The conventions used in this section, and throughout 
the manual, are described in detail in Section 6, 
Introduction to Commands and Arguments. For your 
convenience, a few of the more common conventions 
are listed here: 


@ Characters shown in bold type must be transmitted 
exactly as shown. ; 


@ When communicating with the Plotter, the controller 
should only transmit space characters indicated by 
Sp. Blank spaces between command characters are 
included to improve readability of the text. 


@ ©r stands for Carriage Return (or Return). 


NOTE 


Paper media and fiber-tip pens must be installed 
while performing these procedures. The following 
procedure assumes C-size sheet media and fiber- 
tip pens are installed See the 4663 Operator’s 
Manual for media and pen loading instructions. 
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FIRST TIME — GPIB 


PROCEDURE 


1. Connect the Plotter to the GPIB controller. 


a. 


Check that only media is on the platen; all 
other materials should be kept off the platen at 
all times. 


Turn off the Plotter (if not off already). 


Attach an interconnecting cable between the 
GPIB controller (such as a TEKTRONIX 4050 
Series) and the Plotter’s GPIB port (marked 
IEEE 488-1978). 


Turn on the GPIB controller (hereafter called 
controller). After a few seconds, press the 
HOME/PAGE key on the TEKTRONIX 4050 
Series controller to erase the screen. 


2. Set the Plotter’s front panel switches. 


a. 


Turn the POWER switch on and wait 5 to 10 
seconds for the Plotter to initialize. 


Check that the INTERFACE switches are set to 
ONLINE/REMOTE (both lights on). 


Select either PEN 1 or PEN 2 with the 
appropriate (Pen Control) SELECT switch. 


3. Make the Parameter Entry Card selections. 


NOTE 


Push the Parameter Entry Card fully in before 
making any selections. 


NOTE 


You need select only the Parameter Entry Card 
lines listed here. 


a. 


Parameter Setup Select — SETUP 1. (If the 
INIT fight on the Parameter Entry Module is on, 
momentarily push the Parameter Entry Card 
fully in before resuming this procedure.) 


b. Media Form—SHEET. (Set to ROLL if the 
Media Advance Option is installed and roll 
media is installed.) 


c. Initial Page Size — C. 
NOTE 


You can select any of the other pre-defined sizes 
(B, A, A2, A3, or A4) on this line and you can 
select the other format (GRAPHING) on the next 
line. If you select a new combination, you may 
observe a Slight difference between the plotted 
results and Figure 3-1. 

d. Initial Page Format — DRAFTING. 

e. Page Orientation — HORIZONTAL. 

f. Initial Aspect Ratio — FULL PAGE. 


g. Initial Axis Orientation — Select leftmost 
column. 


h. Line Quality — PREVIEW. 
i. Pen Parameter Access — PEN 1. 
j. Pen Type — FIBERTIP. 


NOTE 


To set the Pen Type for Pen 2, select PEN 2 on 
the Pen Parameter Access line, and then select 
FIBER TIP on the Pen Type line. The next two 


lines, Pen Pressure and Pen Velocity Limit, are set 
automatically. 


k. 


Alpha Character Quality — NORMAL. 


Interface Select — 2. (Select 1 if Option 4 is 
installed.) (if the Interface Select line selection 
is changed, it will be necessary to momentarily 
push the Parameter Entry Card fully in before 
resuming.) 
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m. Initial Command/Response Format — 1. 
(Non-Tektronix controllers may require a dif- 
ferent selection. Refer to the Parameter Entry 
Card description in Section 5 for details.) 


n. GPIB Device Address — 1. 
o. Interface Mode — NORMAL. 


M663 Interactive Digital Plotter (GPIB) 


HENCE |S 
£LAOUGSU 


rec ABC 


ABC 
DEF 
ABC 





Boer 


aBcA\ 














FIRST TIME — GPIB 


p. Interface Functions — CR GENERATES LF. 
(Press either switch.) 


NOTE 


The remaining lines on the Parameter Entry Card 
may be ignored. 


q. Push the Parameter Entry Card back into the 
Plotter. No other selections are required at this 
time. 

















el 
3806-68 





Figure 3-1. Plot Produced by Section 3 Procedures. 
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FIRST TIME — GPIB 


4. Execute the following samples of Plotter com- 
mands. 


NOTE 


In this manual, the ASCII Space character is 
always represented by Sp. The use of spacing 
within command descriptions is for clarity of 
presentation only. Do not send a Space character 
in place of spacing. The following example 
contains two Space characters: 


PRINT @1,32: “P ThreeSpwordSpexample.” °r 


a. Move the pen carriage near the upper-left 
corner of the Page: 


PRINT @1,32: “AH” Cr 
b. Print: 4663 Interactive Digital Plotter 


PRINT @1,32: “P 46635pinteractiveSp 
DigitalSp PlotterSp(GPIB)” Cr 


The alphanumeric text within the quotes (ex- 
cept for the first P) will be printed, followed by 
a Carriage return and line feed. 


NOTE 
The P in the PRINT command is the Plotter 


command code for “print” and will not be printed. 


c. Transmit the following MOVE command to 
move the pen Carriage to a point near the 
center of the Page: 


PRINT @1,32: “M”; 65;50 Cr 


d. Todraw a horizontal vector from this point 
transmit a DRAW command: 


PRINT@1,32: “D”; 100;50 Sr 


e. To move two character spaces to the right and 
down one line space, type a CHARACTER 
MOVE command: 


PRINT@1,32: “AM”; 2;-1 Cr 


Draw dashed line vectors. 
a. Transmit a SET DASH PATTERN command: 
PRINT@1,32: “BD”; 2:3 Sr 


This determines the proportion of blank line to 
drawn line. 


b. Establish a 10 GDU long dash pattern length 
using the SET DASH PATTERN LENGTH com- 
mand: 


PRINT @1,32: “BS”; 10 Sr 


c. Transmit a SELECT LINE TYPE command to 
establish fixed dash- pattern-length line type: 
PRINT@1,32: “BL”; 1 Cr 


d. !ssue a DRAW command to cause the Plotter to 
draw a dashed line from the current pen 
carriage position to the point determined by 
the command coordinates: 


PRINT @1,32: “D”; 130;10 Sr 


e. Toreset the Plotter solid line type, transmit a 
SELECT LINE TYPE command: 


PRINT @1,32: “BL”; 0 Sp 


Change the font selection. 


a. Transmit a MOVE command to move the pen 
carriage to the left edge of the Page and down 
from the top: 


PRINT @1,32: “M”; 0;80 Cr 


b. Transmit the following PRINT command; notice 
that the printed characters appear like those of 
the first line in Figure 3-2. 


PRINT@1,32:"P4[\ ] { |}’°r 


FONT 0: He ee | a 


FONT 2: EAOUaSU 





Figure 3-2. Fonts 0 and 2. 
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a. 


a. 


To select Font 2, transmit a SELECT 
STANDARD ALPHA FONT commana: 


PRINT @1,32: “F”; 2 Cr 


Transmit the following PRINT command; notice 
that the printed characters appear like those of 
the second line in Figure 3-1. 


PRINT@1,32: “P4[\] {|}? ¢r 
Reset the alpha parameters: 
PRINT@1,32: “A” Cr 


Change the printed character size. 


Transmit a MOVE command to move the pen to 
the left edge and down from the top: 


PRINT @1,32: “M”; 0;65 Cr 
Print ABC: 

PRINT @1,32: “P ABC” ; Sr 
Transmit an ALPHA SIZE command: 

PRINT @1,32: “BZ”; 3.24;4.66 r 
Print ABC: 

PRINT@1,32: “P ABC” Cr 


The printed characters will be approximately 
three times as large as they were for step 7b. 


Set the alpha parameters back to default: 
PRINT @1,32: “A” Cr 


Change the alpha ratio. 


Transmit the following commands: 
PRINT @1,32: “P ABC” Cr 
PRINT@1,32: “P DEF” Cr 

Change the alpha ratio: 
PRINT@1,32: “BI”; 3;3.27 Cr 

Repeat Step 8a. 


The Plotter prints characters of the same size, 
but with a distance from the origin of one 
character to the origin of the next character 
which is twice the default distance; the dis- 
tance from the baseline of one line of printing 
to the baseline of the next line of printing is 
approximately twice the default distance. 


Reset the alpha parameters to their default 
values: 


PRINT @1,32: “A” Cr 
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10. 


FIRST TIME — GPIB 


Change the alpha scaling factors. 


a. 


To alter the X and Y multiplication factors for 
alpha characters, transmit a SET ALPHA 
SCALE command: 

PRINT @1,32: “BH”; 3;2 Sr 
Transmit the following command: 

PRINT @1,32: “P ABC” ; pr 


Notice that the characters and character-to- 
character spacings are three times as wide 
and three times as high as they were before 
the SET ALPHA SCALE command in step Qb. 


To reset the scaling factors to the default 

condition, transmit a SET ALPHA SCALE com- 

mand with magnification factors 1,1: 
PRINT@1,32: “BH”; 1;1 Cr 


Transmit the following Plotter PRINT command 
to verify that the characters are printed with 
default size and spacing: 


PRINT @1,32: “P ABC” Cr 


Print characters on a diagonal line. 


a. 


Move the pen carriage near the center of the 
media: 

PRINT @1,32: “M”; 65;65 Cr 
To set the printing angle (and to set the left 
margin), transmit a SET ALPHA ROTATION 
command: 


PRINT @1,32: “R”; 45 Cr 
Transmit the following 4663 PRINT command: 
PRINT @1,32: “P ABC” ; Sr 


The characters are printed on a line rotated 
45° from horizontal. 


A right margin is established by transmitting a 
SET ALPHA MARGIN SEPARATION command: 


PRINT @1,32: “BR”; 10 Sr 


Print the rest of the alphabet and notice that 
after ten characters have been typed on a line, 
the Plotter automatically executes a carriage 
return and a line feed and starts printing on the 
next line. Also, notice that both margins (left 
and right) are perpendicular to the printing 
direction (which in this case is at a 45° angle). 


PRINT @1,32: “P DEFGHIJKLMNOPQRS- 
TUVWXYZ”; Cr 
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FIRST TIME — GPIB 


11. Change the slant of the printed characters. 


a. 


Slanted characters can be printed by transmit- 
ting a SET ALPHA SLANT command: 


PRINT@1,32: “BG”; 20 Cr 
Print three alphabetic characters: 
PRINT @1,32: “P ABC” Cr 


Notice that these characters, although printed 
along the 45° angle printing axis are, in 
addition, slanted to the right 20°. 


Reset the alpha parameters: 
PRINT@1,32: “A” Cr 


12 Sample transform commands. 
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To illustrate some of the transform commands, 
first draw a Square box and then modify it with 
some of the transform commands. 


Transmit a MOVE command to position the pen 
carriage near the lower-left corner: 


PRINT @1,32: “M”; 15;0 Cr 


To draw the box, transmit the following DRAW 
commands: 


PRINT@1,32: “D”; 30;0 Cr 
PRINT @1,32: “D”; 30;15 Cr 
PRINT @1,32: “D”; 15;15 °r 
PRINT@1,32: “D”; 15;0 Cr 


A box with 15 GDU sides will be drawn with its 
lower-left corner 15 GDUs to the right of the 
Viewport origin. 


To save the present (default) transform, 
transmit a SAVE CURRENT TRANSFORM com- 
mand: 


PRINT @1,32: “AX” Cr 


To change the X-Y scaling factors for subse- 
quent graphing, transmit a SET SCALE com- 
mand: 


PRINT @1,32: “AS”; 2;3 Cr 


Retransmit the commands in steps 12a and 
12b. Notice that this box is twice as wide and 
three times as high as the first box and is 
displaced to the immediate right of the first 
box. The lower-left corner of both boxes is 15,0 
but 15 on the X-axis, after rescaling, begins 
twice as far from the origin as when drawing 
the first box. 


f. 


To restore the default transform matrix and 
delete the scaled transform matrix, transmit a 
RESTORE PREVIOUS TRANSFORM command: 


PRINT@1,32: “AY” Cr 


13. Rotate the Viewport. 


14. 


a. 


a. 


Transmit the SAVE CURRENT TRANSFORM 
command to save the present (default) 
transform matrix: 


PRINT @1 ,32: “AX” Cr 


To rotate the axes of the Viewport 40°, transmit 
a SET ROTATION command: 


PRINT@1,32: “AR”; 40 Cr 


Then retransmit the commands in Steps 12a 
and 12b Notice that the box is redrawn and 
rotated counterclockwise by 40°. 


To restore the default transform matrix and 
delete the current transform matrix, transmit a 
RESTORE PREVIOUS TRANSFORM command: 


PRINT@1,32: “AY” Sr 


Establish a new Viewport. 


To mark the Initial Viewport, transmit a MARK 
VIEWPORT command: 


PRINT @1,32: “CM” Cr 
Transmit a SET VIEWPORT command: 
PRINT @1,32: “AV”; 65;130,2;47 Cr 


To outline this new Viewport, transmit an 
OUTLINE VIEWPORT command: 


PRINT @1,32: “CB” Cr 


Redraw the box using the commands in steps 
12a and 1 2b. Notice that the box and the 
Viewport outline in step 12c are reduced in 
size proportionately. 


To restore the Initial Viewport transform matrix, 
pull the Parameter Entry Card out to the Initial 
Page Size line and press the switch over “C”’. 


NOTE 


Even though that switch’s light will still be on, you 
must press the switch at this time. The Viewport 
size then becomes the same as the Initial Page 


size. 
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15. Disable one axis of the Joystick. 


This command could be used, for example, when 
digitizing the Y-coordinates of a graph at a fixed X- 
axis location. 


a. 


To disable the X-axis of the Joystick, transmit 
a JOYSTICK DISABLE command and specify 
the X-axis: 


PRINT@1,32: “BJ”; 1 Cr 


Move the Joystick around and notice that the 
pen only moves along the Y-axis. 


Both axes of the Joystick are again enabled 
anytime the host repositions the pen or anoth- 
er JOYSTICK DISABLE command is given, 
specifying that neither axis be disabled. Issue 
a JOYSTICK DISABLE command to enable the 
Joystick: 


PRINT@1,32: “BJ”; 0 Cr 
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16. Obtain digitized pen carriage coordinates. 


a. Position the pen near the center of the 
Viewport: 


PRINT @1,32: “M”; 65;50 Cr 


Remember, the Plotter is now operating with 
the Initial Viewport and the small Viewport 
created earlier has been deleted. 


b. To display the pen carriage coordinates (in 
GDUs) on the display screen, transmit the 
following sequence: 


PRINT @1,32: “G” Sr 
INPUT@1,32: X,Y,T Sr 
PRINT X,Y,T °r 


Notice that the first two numbers indicate the 
coordinates, respectively, for the MOVE 
command in step 16a. 


c. Use the Joystick to move the pen carriage. 
Repeat the previous command sequence in 
step 16b. The new pen coordinates will be be 
printed on the controller’s display. 


This completes the familiarization procedure for the 
GPIB interface commands. 
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Section 4 


SERIAL INTERFACE 


INTRODUCTION 


This section describes two aspects of the Serial 
interface. These are: 


@ How to install the Plotter into a system while 
considering (1) connecting the Plotter to other serial 
devices, (2) making proper selections on the Para- 
menter Entry Card to permit device communication 
with the Plotter, and (3) determining the best method 
to control information flow between devices and the 


Plotter. 


@ How to program the Plotter by (1) understanding the 


various ways in which Plotter commands are format- 
ted, and (2) seeing how any resulting Plotter re- 
sponses are decoded. 


CONNECTING THE PLOTTER TO OTHER DEVICES 


The flexibility provided by the front panel Interface 
Switching Function and the Parameter Entry Card 
allows the Plotter to be connected with other devices in 
a variety of ways. The following describes four basic 


“a” “we ways to interconnect the Plotter with a host computer, 


a terminal, or a storage device: 
@ The Plotter is connected as a peripheral to the host. 


® The Plotter is connected in a loop-thru configuration 
to a terminal (where the host talks through the 
Plotter to the terminal). 


@ The Plotter is connected as a peripheral toa 
terminal. 

@ The Plotter operates ih conjunction with an offline 
storage device (for example, a host does not exist in 
the system). 
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CONNECTED AS A HOST PERIPHERAL 


In this configuration, the Plotter is viewed as an 
independent peripheral available to the host. A host 
peripheral configuration is most appropriate when the 
Plotter is a resource available to all host-system users. 


The Plotter can be located near the host or located at a 
remote location (possibly with a terminal). Figure 4-1A 
illustrates the simplest version of this configuration 
where the Plotter is connected to the host through a 
dedicated input/output (I/O) port. When the Plotter is 
located near the host, modems are not required. Figure 
4-1B shows an equivalent configuration where a single 
communication line to either the remote Plotter or 
terminal is shared using a multiplexer/modem 
combination. The software support for this configura- 
tion is the same as shown in Figure 4-1A. 
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SERIAL INTERFACE 
CONNECTING PLOTTER TO OTHER DEVICES 


HOST 
COMPUTER 


A. Host Peripheral Separate Communications Lines 


TERMINAL 


MULTIPLEXER MULTIPLEXER 
MODEM MODEM 


B. Host Peripheral Multiplexed Communications Lines 





Figure 4-1. Host Peripheral Configurations. = 
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CONNECTED IN A LOOP-THRU 
CONFIGURATION 


For the configuration illustrated in Figure 4-2, the 
Plotter and terminal are connected in a loop-thru 
fashion in order to share a common communication line 
to the host. This configuration is appropriate when 
graphics to be drawn on the Plotter are generated by 
the host while under interactive control of the terminal. 


Software support for this configuration is slightly more 
complex as the host must direct its communication 
through the single I/O port either to the terminal or to 
the Plotter. This is easily done with the Plotter’s 


PLOTTER 





SERIAL INTERFACE 
CONNECTING PLOTTER TO OTHER DEVICES 


DEVICE ON and DEVICE OFF commands. When the 
host sends a DEVICE ON command to the Plotter 
(enabling the Plotter to recognize later commands), the 
Plotter interrupts command flow to the terminal. 


A subsequent DEVICE OFF command disables the 
Plotter and allows the host to again access the terminal 
through the Plotter. Also, in this configuration, the 
Plotter can be used as a terminal peripheral if directed 
by the 4663 front panel Interface Switching function to 
communicate only with the terminal. The loop-thru 
configuration allows operation of the Plotter with 
virtually any type of terminal having a Serial interface. 


HOST 
COMPUTER 


Figure 4-2. Host Peripheral Communications Line With Loop-Thru. 
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SERIAL INTERFACE 
CONNECTING PLOTTER TO OTHER DEVICES 


CONNECTED AS A TERMINAL 
PERIPHERAL 


The configuration shown in Figure 4-3 gives the 
terminal priority over the host computer to use the 
Plotter as a peripheral. The terminal peripheral configu- 
ration is most appropriate when graphics to be plotted 
are generated either by the host or by the terminal. The 
terminal communicates with the Plotter directly, while 
the host must address the terminal to reach the Plotter. 


Limiting host communication to only the terminal may 
simplify host support programs that deal with the 
terminal through the I/O port. This occurs especially 
when Plotter features used are the same as the 
available terminal features. If other unique Plotter 
features are used, more host software may be required 
to access the unique features through the terminal. 


Other advantages of this configuration depend upon 
the terminal’s capability. Refer to the specific Opera- 
tor’s Manual for the terminal. (Some terminals may be 
able to do background plotting from local data storage 
while continuously communicating with the host.) 


PLOTTER 


TERMINAL 


Possible configurations with TEKTRONIX terminals are 
listed in Table 4-1 which notes any terminal interface 
options that must be present. 


Table 4-1 


TERMINAL INTERFACE OPTIONS REQUIRED 
WHEN CONFIGURING THE PLOTTER 
AS A TERMINAL PERIPHERAL 



































Tektronix Interface 

Terminals Description Option 
——————}— 

4010, 4012, | With Dual Interface Capability Option 36 
4014, 4015 

4016 With Dual Interface Capability Option 35 
4112,4114 | With 3-Port Peripheral! Interface | Option 10 
4025, 4027 | With Peripheral Interface Option 044 
4014,4015 | With Local Processor Option 05? 








8For these configurations, terminal communication with the the host Is by a 
Serial interface, while terminal communication with the Plotter Is by a GPIB 
Interface. Refer to Section 5 of this manual for GPIB Information. 


COMPUTER 


Figure 4-3. Terminal Peripheral Configuration. 
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OFFLINE PLOTTING 


If data to be plotted is recorded on a storage media 
(such as magnetic tape or floppy disk), the Plotter can 
be configured as shown in Figure 4-4. This 
configuration permits data to be plotted without need- 
ing a termina! or a host computer as a controller. An 
example of a data storage device with a Serial interface 
is the TEKTRONIX 4923 Digital Tape Drive Unit with 
Option 01. 


DATA 
STORAGE PLOTTER 
DEVICE 





Figure 4-4. OFFLINE Plotting Configuration. 
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SERIAL INTERFACE 
CONNECTING PLOTTER TO OTHER DEVICES 


Two combination systems are shown in Figure 4-5. 
These systems use a TEKTRONIX 4010 Series termi- 
nal with either a standard 4923 Digital Tape Drive Unit 
or a 4923 Digital Tape Drive Unit with Option 01. These 
configurations allow plot data to be recorded while 
online with the host computer and then later plotted 
during offline time. The REMOTE and LOCAL switching 
functions on both the tape unit and the Plotter direct 
the routing of the plot data. 


MULTIPLE PLOTTERS 


Multiple Plotters can be installed in a loop-thru confi- 
guration in place of the single Plotter described in any 
of the above configurations. Each of the Plotters can be 
set to the same device address and receive identical 
data in parallel or each can use a different device 
address and receive data independently. Refer to 
Communicating With Other Devices, further in this 
section for details about multiple plotter configurations. 
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SERIAL INTERFACE 
CONNECTING PLOTTER TO OTHER DEVICES 


HOST 
COMPUTER 


TERMINAL PLOTTER 


HOST 
COMPUTER 


TERMINAL PLOTTER 


3806-11 





Figure 4-5. ONLINE Recording and OFFLINE Plotting. 
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SERIAL INTERFACE 
SETTING UP PARAMETER ENTRY CARD 


SETTING UP THE PARAMETER ENTRY CARD 


Selections made on the Parameter Entry Card lines 
permit the Plotter to operate in a variety of 
communications environments. Described here are the 
possible selections and information needed to choose 
selections for a particular communication environment. 


The majority of the Paramenter Entry Card lines 
described here are from the Serial Interface portion of 
the Paramenter Entry Card. Refer to Figure 4-6. Two 
other lines, Interface Select and Initial Com- 
mand/Response Format, are also included since they 
must be set specifically for each interface type in- 
stalled in the Plotter. 


Refer to the description of the Parameter Entry Card in 
the 4663 Operator’s Manual for details about making 
any of the selections described in this section. 


INTERFACE SELECT LINE 


The selection made on the Interface Select line 
determines which hardware interface is active. As 
shipped from the factory (with the standard RS-232-C 
Interface for Serial or with the Option 01 interface for 
Serial and GPIB), selecting “1” on the Interface Select 
line activates the Serial interface. Selecting “2” 
activates the GPIB interface. If the Plotter is shipped 
with Option 04 (GPIB Only Option), the “1” selection 
activates the GPIB interface and the “2” selection is 


inactive. Table 4-2 summarizes the possible selections. 


NOTE 


The interface activated by selection of “1” or “2” 
on the Interface Select Line could be changed by 
resetting straps on the Interface circuit board. 
Refer to the 4663 Service Manual for additional 

















information. 
Table 4-2 

INTERFACE DESIGNATIONS 
Interface(s) Option | Interface Select Line 
Installed Number 1 2 
Serial Only Standard | SERIAL Not used 
Serial and GPIB | Option 01 | SERIAL GPIB 
GPIB Only Option 04 | GPIB Not used 
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INITIAL COMMAND/RESPONSE FORMAT 
LINE 


The selection made on the Initial Command/Response 
Format line configures the Serial interface to accept 
commands and send responses in a specified format. 
Refer to Introduction to Serial Commands and Re- 
sponses, in this section for more information about the 
various Command and response formats. 


If the Piotter is being installed to operate with existing 
host software, then the Initial Command/Response 
Format line selecticn must agree with the host software 
formatting requirements. If new host software is being 
developed to drive the Plotter, then the choice of a 
format line can be based upon the tradeoff between 
communications performance and host software 
complexity. The following paragraphs describe each of 
the Initial Command/Response Format line selections 
and indicate how an appropriate choice can be made. 


NOTE 


When certain events occur, selection of the Initial 
Command/Response Format configures the inter- 
face to accept the specified format. These events 
are: (1) at power-up, (2) when a new selection is 
made on the Initial/Command Response Format 
line, (3) when the Serial interface is first selected 
on the Interface Select line, and (4) when an 
INTERFACE PARAMETER RESET command is 
received. 


The SELECT COMMAND/RESPONSE FORMAT 
command overrides the Initial Com- 
mand/Response Format line selection but does 
not modify it. This allows the configuration de- 
fined by the Parameter Entry Card selection to be 
restored when one of the above listed conditions 
occurs. 


NOTE 


The following describes only the Initial Com- 
mand/Response Formats as they apply to a Serial 
interface. The function of each format changes 
when the GPIB interface is selected. Refer to 
Section 5 for information about the GPIB 
Command/Response Formats. 
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SETTING UP PARAMETER ENTRY CARD 


| | - 
SERIAL INTERFACE 
} 
H 


wrenrace Functions | encenenaresip || [| | TT 
LISTEN 

wrenrace mone | wonmat | ‘Ger | ome | | | ST CT 

cris oevce anoness [1 {| 2 | 3 | «4 | 5 | 6 | 7 | os | 


PEN VELOCITY LIMIT 6 IPS 8 IPS 10 “ee ae IPS 14 IPS 16 IPS a areeo x 

PEN PRESSURE Fon [wom [wow | coon [arom [soon [oom [10 0 
4 ee WET PLASTIC 

PEN TYPE OE aC 

ra rmmnrancas [rar fens? | | |_| |__| 


INITIAL AXIS Y Y 
oe ET" [XC y | v] 
INITIAL ASPECT RATIO — ‘| Past 4x:3Y | 1xay | 3x:4Y fexee [of] 


A4 RECALL SAVE 
ENGLISH Metaic USER DEFINED 
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z 
i@ 
Figure 4-6. Parameter Entry Card Lines for the Serial Interface. a 
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Command/Response Format 1 


Format 1 features are: 
@ 4663 Command Set 
e@ Packed Binary Response Encoding 


Format 1 is the standard 4663 Command Response 
Format used with TEKTRONIX PLOT 10 Graphic 
Library 4663 support software. All 4663 commands 
can be used in Format 1. This format has the widest 
range of command and argument forms available. 


For maximum transmission efficiency, any responses 
transmitted by the Plotter are encoded in a packed 
binary format that must be decoded by the host. This 
involves packing the binary bits of the output values 
into seven ASCII characters for transmission rather 
than converting the values to ASCII decimal numbers 
(which could take up to 33 characters). The packed- 
binary format limits the numerical range of response 
values (refer to Output Responses near the end of this 
section for more information). 


Command/Response Format 2 


/ Format 2 features are: 


@ 4663 Command Set 

@ ASCII Decimal Response Encoding 

Format 2 is an optional 4663 Command/Response 
Format. All 4663 commands can be used as in Format 
1, but the output responses are encoded in ASCII 
decimal format. This format is less efficient during 
command transmission, but does not require special 
decoding by most host computers and can encode any 
required numerical values. 


Command/Response Format 3 


Format 3 features are: 
@ 4662 Compatible Command Set 
@ 4662 Packed Binary Response Encoding 


Format 3 is a 4662 compatible Command/Response 
Format used with TEKTRONIX PLOT 10 Graphic 
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- Library 4662 support software. This is the format to 


use when a 4663 Plotter is installed in a system that 
currently supports a TEKTRONIX 4662 Plotter. Refer to 
the 4662 Interactive Plotter Programmer’s Reference 
Manual for more information. 


In this format, the 4663 accepts all commands written 
for the 4662 Plotter and any output responses are 
encoded in the 4662 packed-binary format. The 
packed-binary format is similar to the 4663 packed- 
binary format with the exception of TAG value assign- 
ments. Any 4663 Plotter commands generating an 
output response not defined for the 4662 Plotter (such 
as the READ VIEWPORT command) initiates an error 
when used with Format 3. 


All other 4663 commands not generating output are 
accepted (permitting 4662 oriented systems to be 
upgraded). In Format 3, the °r and semicolon charac- 
ters are not recognized as special command delimiters. 


NOTE 


Format 1 can also be used in a 4662-oriented 
system as long as the only output responses 
requested from the 4663 are Block mode 
acknowledge responses. 


Command/Response Format 4 


Format 4 features are: 
@ 4662 Compatible Command Set 
@ Restricted 4662 Packed Binary Response Encoding 


This format is identical to Format 3 with the exception 
that packed-binary coded output is restricted so it will 
not contain the ASCII character “@” (since some hosts 
use this character for special functions). In Format 4, 
any digitized output, generated from either a DIGITIZE 
command or from a front panel Point switch operation, 
always has the least significant bit of the X-coordinate 
set to a “1” (this avoids the ‘‘@” character). For 4662 
compatible operation, the resolution of digitize 
responses, use only twelve bits. Thus, the four least 
significant bits of the coordinates, which normally are 
0, should be ignored by the host. 


SERIAL INTERFACE 
SETTING UP PARAMETER ENTRY CARD 


SERIAL DEVICE ADDRESS LINE 


The selection made on the Serial Device Address line 
configures the Serial interface to accept only Style | 
Plotter commands that contain the selected device 
address character (uppercase A through H). Any Style | 
Plotter command not containing this address is ig- 
nored. (Refer to /ntroduction to Serial Commands and 
Responses later in this section for a discussion of 
Style | commands.) 


RECEIVE/TRANSMIT BAUD RATE LINES 


The selections made on the Receive Baud Rate and 
Transmit Baud Rate lines should correspond to the 
baud rate of the modem, host I/O port, or other 
interconnected devices. 


A wide range of baud rates are available to accomodate 
most communications devices, but if the baud rate 
selected exceeds 1200 baud, then some restrictions 
on communication methods may apply. Refer to Com- 
municating With the Host Computer later in this section 
for a discussion of these restrictions, and how to select 
an optimum baud rate when the available communica- 
tion devices permit a choice of baud rates. 


The Receive Baud Rate and Transmit Baud Rate line 
selections are made independently to permit Plotter 

reception at one rate and transmission at a different 

rate. 


If a modem is used that provides transmit and/or 
receive clocks (such as a synchronous modem used at 
higher baud rates), then the external clock selections 
(1X EXT, 16X EXT, and 64X EXT) must be set to match 
the modem requirements. 


These selections choose an external clock to be 
supplied by the RS-232 connector and specify a clock 
divider ratio. lf a 1X EXT or 64X EXT selection is 
required on a single baud-rate line, the same selection 
must be made on the other line. External clock 
selections made on the Transmit Baud Rate line or on 
the Receive Baud Rate line automatically sets both 
lines to the same rate. If a 16X EXT selection is 
required on a single baud-rate line, then one of the 
non-external baud rate selections may optionally be 
made on the other line. When an external clock is used, 
the baud rate is determined entirely by the external 
clock frequency and the clock dividing ratio. The 
maximum clock frequency to be used is 307 KHz. This 
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gives the maximum baud rate obtainable when using 
each of the clock divider ratios as shown below: 


x1 EXT 307 KBaud 
X16 EXT 19.1875 KBaud 
X64 EXT 4.7968 KBaud 


Although interface hardware can receive characters up 
to rates of 307 KBaud, the Plotter cannot process 
sequential characters at a rate greater than 9600 
Baud. Therefore, a delay must be added between 
successive characters when communicating at baud 
rates greater than 9600 baud to reduce the effective 
baud rate to 9600 baud or less. 


NOTE 


If the interface requires an X71 external clock 
signal, the signal must have a rising edge near 
the center of the bit cell. 


TRANSMIT BAUD RATE LIMIT LINE 


The Transmit Baud Rate Limit line can be used to 
accomodate hosts that are unable to accept a 
continuous string of characters at the current transmit 
baud rate. A selection on this line configures the 
interface to effectively reduce the current transmit 
baud rate to the specified value by pausing between 
transmitted characters (where each character is sent 
at the current transmit baud rate). 


The required Transmit Baud Rate Limit needed to 
communicate with a given host varies widely depend- 
ing upon the communications capabilities of the host 
and its current processing load. This rate may require a 
very conservative selection (such as a low limit value) 
to allow communication during all conditions. A typical 
limit would be approximately 300 to 600 baud (30 to 60 
characters per second), which approximates the maxi- 
mum input capability of a terminal operator. 


For hosts without a low rate restriction, select FULL 
SPEED to permit response transmission at the speci- 
fied transmit baud rate. 


NOTE 


The Transmit Baud Rate Limit line must be set to 
FULL SPEED if selections are made on the 
DC1/DC3 Control line of the Parameter Entry 
Card. 
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CHARACTER FORMAT LINE 


The selections made on the Character Format line 
configures the interface to accept and send characters 
in the desired format. The DATA BITS/CHARACTER 
selection should be ‘‘7” if the parity of the received 
characters is to be checked (the Plotter communicates 
using 7-bit ASCII characters plus a parity bit). If the 
received character parity is to be ignored, then 8-bit 
characters should be specified. The parity check is 
enabled by the selection made on the Receive 
Parity/Transmit Parity line. 


The STOP BITS selection specifies that each transmit- 
ted response character is to be formatted with 1 or 2 
stop bits. Normally, “2” is selected for greatest reliabili- 
ty when transmitting at baud rates greater than 1200 
baud. However, if communications equipment requires 
only one stop bit, “1” may be selected to improve 
transmission efficiency. The Plotter can receive char- 
acters with 1 or 2 stop bits irrespective of the STOP 
BIT selection. 


NOTE 


The 8 data bits per character and the 2 stop bits 
is an illegal combination of parameters when 
parity checking is enabled. Any selection on this 
line resulting in this combination causes parity 
checking to be automatically disabled by forcing 
the selection on the Receive Parity/Transmit 
Parity line to be IGNORE/LOGIC 1. 


RECEIVE PARITY/TRANSMIT PARITY LINE 


The Receive Parity/Transmit Parity line permits 
selection of the desired parity checks for received 
characters and specifies the parity bit (most significant 
bit) for transmitted characters. The choices include the 
following: 


@ ODD/ODD — Checks received characters for odd 
parity and sends transmitted characters with odd 
parity. 

@ EVEN/EVEN — Checks received characters for even 
parity and sends transmitted characters with even 
parity. 

@ IGNORE/LOGIC 0 — Disables any receive parity 
check and sets transmitted parity bits to LOGIC 0. 


@ IGNORE/LOGIC 1 — Disables any receive parity 
check and sets transmitted parity bits to LOGIC 1. 
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An IGNORE/LOGIC 0 or IGNORE/LOGIC 1 selection 
may be used if the communications devices do not 
require parity checks of responses that are transmitted 
by the Plotter. These choices accomodate host com- 
puters that require the parity bit for transmitted 
characters be set to a 1 or a O, even when parity 
checking is not performed. 


NOTE 


Parity checking is illegal if 8 data bits per 
character and 2 stop bits are the current Charac- 
ter Format parameters. Any selection on this line 
that enables parity checking and results in this 
combination causes the STOP BIT selection on 
the Character Format line to automatically be- 
come 7 stop bit. 


COMMUNICATIONS CONTROL MODE LINE 


The selection made on the Communications Control 
Mode line establishes the communications protocol. 
(Refer to Communicating With Other Devices later in 
this section for more information on communications, 
including input/output rate control and the hardware 
flagging function.) 


Both selections (FULL DUPLEX and HARDWARE 
RECEIVE FLAGGING) support full duplex communica- 
tion (for example, simultaneous receive and transmit 
operations). The FULL DUPLEX selection is used when 
no active input rate control is desired. FULL DUPLEX is 
the normal selection unless HARDWARE RECEIVE 
FLAGGING has been chosen as the input rate control 
method. The FULL DUPLEX selection causes the RS- 
232-C Data Terminal Ready control line to be asserted 
whenever the Plotter’s power is on (and any terminal 
connected in the loop-thru configuration is also assert- 
ing Data Terminal Ready). The HARDWARE RECEIVE 
FLAGGING selection enables the interface to provide 
active input rate control by using Data Terminal Ready 
to contro! transmission between other connected de- 
vices and the Plotter. 


Hardware transmit flagging is always in effect, and the 
RS-232-C signal line Clear To Send must be asserted 
before transmission of a response character can begin. 
HARDWARE RECEIVE FLAGGING provides a 
convenient rate control method when supported by the 
other interconnected devices. 


NOTE 


When HARDWARE RECEIVE FLAGGING is cho- 
sen, selections should not be made on the 
DC1/DC3 Control! line. 
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DC1/DC3 CONTROL LINE 


The DC1/DC3 Control line enables the interface to use 
software flagging to provide active input and/or output 
rate control between other connected devices and the 
Plotter. (Refer to Communicating With Other Devices 
later in this section for more information on communi- 
cations, including input/output rate control and the 
DC1/DC3 flagging function.) 


The INPUT selection permits the Plotter to regulate the 
effective transmission rate of a connected device, while 
the OUTPUT selection permits a connected device to 
control the Plotter’s effective transmission rate. In 
these modes, an ASCII DC3 (stop read) contro! charac- 
ter (CTRL S) and an ASCII DC1 (start read) control 
character (CTRL Q) are used to stop or start data 
transmissions between the Plotter or other connected 
devices to prevent overloading the receiving device. 
The DC1/DC3 Control functions provide a convenient 
control method when supported by the other connected 
devices. 


NOTE 


To use this function, FULL DUPLEX should be 
selected on the Communications Control Mode 
line and the Transmit Baud Rate Limit line 
selection must be FULL SPEED. 


INTERFACE FUNCTIONS LINE 


Selections made on the Interface Functions line must 
match the Plotter interface to a particular 
communications environment. These selections are 
AUTO MUTE, CR GENERATES LF, DEL IGNORE, and 
CARRIER DETECT. The following describes each se- 
lection and indicates the communications environment 
in which each could be used. 


Auto Mute 


Use the AUTO MUTE selection when the Plotter is 
installed in a loop-thru configuration. This selection 
prevents commands sent from either the host or other 
connected devices to the Plotter from being displayed 
on the terminal’s screen. When AUTO MUTE is not 
selected, all data from other connected devices re- 
ceived by the Plotter also passes through the Plotter’s 
interface to the terminal. 


NOTE 


If the Plotter is logically off, and AUTO MUTE is 
selected, a portion of the next PLOTTER ON 
command will be sent to the terminal before the 
mute function is activated. 


At a receive baud rate of 9600, characters 
following the DEVICE OFF command may be 
garbled by the terminal if characters received by 
the Plotter do not contain two stop bits. Alterna- 
tively, there either should be a delay of about one 
character-time following the DEVICE OFF 
command, or the DEVICE OFF command should 
be followed by an ASCII °+ character with even 
parity. 


Refer to Communicating With Other Devices further in 
this section for a discussion of the AUTO MUTE 
function. 


CR Generates LF 


The CR GENERATES LF selection forces the Plotter to 
automatically generate a line feed following each ASCII 
carriage return (Cr) character that the host sends to the 
Plotter for printing. This selection is used when com- 
municating with host computers that do not provide an 
automatic line feed after each ©r character. 
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Delete Ignore 


Use the DEL IGNORE selection when communicating 
with host computers that use the ASCII ®7 (DEL) 
character for special system functions. This selection 
causes any Pt characters to be ignored rather than 
used as a portion of a Style II command. An alternative 
two-character sequence “1 ? may be sent from the host 
computer in place of °r characters, which appear in 
Style Il commands. Refer to /ntroduction to Seria! 
Commands and Responses later in this section for 
more information about Style I] commands. 


Carrier Detect 


When CARRIER DETECT is selected, the RS-232-C 
Receive Line Signal Detector (DATA CARRIER DE- 
TECT) signal line is monitored. If the signal is removed 
even momentarily, the front panel REMOTE light starts 
blinking to indicate a possible loss of data. Pressing 
the REMOTE switch on the Plotter cancels this status 
indication. Refer to Communicating With Other Devices 
further in this section for more details. 


NOTE 


The Plotter will not receive data if the RS-232-C 
Receive Line Signal Detector signal is held in an 
unasserted state. 
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ATTENTION CHARACTER LINE 


The selection made on this line specifies the attention 
character used in the definition of Style | and Style Il 
commands. The ASCII ce (ESC) character is the usual 
selection and is compatible with the TEKTRONIX 4010 
Series terminals, which also use Style Il commands. 
However, the remaining three selections (“!", “A”, or 
SYN) may be useful in some communications environ- 
ments where, for example, the host computer is not 
able to transmit an -c character. Refer to Introduction 
to Serial Commands and Responses later in this 
section for more information about Style | and Style II 
commands. 


OUTPUT TERMINATOR LINE 


The selection made on this line specifies the Plotter’s 
response termination characters to be used when the 
Plotter transmits messages back to the host computer. 


The three selections available are CR, CR & EOT, or 
NONE. A host computer with line-oriented input 
normally requires a carriage return ©r terminator or 
possibly a ©r followed by an §+ (EOT) character to 
indicate the end of an input line. A host with character- 
oriented input may not require a response terminator 
and any selection (including NONE) would be accepta- 
ble. 
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COMMUNICATING WITH OTHER DEVICES 


The following presentation describes how command 
and response transmissions are sent between the 
Plotter and other connected devices. This information 
is described under the following headings: 


® Selecting a Communications Control Mode 
Interface Switching Function 

RS-232-C Lines for the Loop-Thru Configuration 
Device-to-Plotter Transmission 


Plotter-to-Device Transmission 


Communicating With Multiple Plotters 


Two activities must be considered when transmitting 
commands and responses between the Plotter and the 
host computer (or other devices). The first is the 
detection and possible correction of transmis: ) on 
errors. This activity is optional and is discussed later in 
the manual. 


The second activity is control of the rate at which 
commands and responses are passed between the 
Plotter and the host computer. As the Plotter is an 
electro mechanical device, the rate at which it 
processes received plot commands is normally slower 
than the rate at which the host computer or other 
devices can send commands. Thus, the Plotter must 
interactively control the rate at which commands are 
received to avoid loss of information. This process is 
refered to as input rate control. 


Likewise, some host computer configurations require 
slow data input and cannot receive Plotter responses 
as rapidly as the Plotter can generate them. Thus, 
Plotter output must also be controlled to match the 
requirements of the host computer (output rate con- 
trol). The following discussion explains how to select 
the optimum method to manage communication be- 
tween the Plotter and connected devices. 
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The following information provides a quick summary of 
advantages and limitations for each of the communica- 
tion control modes which provide input rate control 
and, in some cases, error control of transmissions from 
an interconnected device to the Plotter. This summary 
should help select the communications control mode 
most appropriate for a given application or communica- 
tion environment. 


There are four individual modes; Continuous mode, 
Hardware Flagging mode, DC1/DC3 Flagging mode, 
and Block mode. Additional information for each of 
these modes is presented under Device-to-Plotter 
Transmission, later in this section. 


Selecting contro! methods for Plotter transmissions to 
connected devices is done separately and described 
under Plotter-to-Device Transmission later in this sec- 
tion. 


Continuous Mode 


This is the Plotter’s default mode upon power-up if 
Hardware Flagging or DC1/DC3 Flagging modes have 
not been enabled. Input Rate Control is provided by 
selecting an appropriate receive baud rate which gives 
a simple low performance control mode as indicated 
below. Advantages of Continuous mode are: 


@ No transmitting device support is required (may use 
on any system). 
Limitations of Continuous mode are: 


@ Input baud rate must satisfy limitations. For small 
plots (less than 300 graphic commands) the baud 
rate used should be less than 2400. For larger plots, 
the baud rate should be less than 300. 
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@ Provides parity error detection only with no 
correction of transmission errors. 


@ Lower input baud rates are required if programmable 
macro or downloadable characters are defined. 


NOTE 


The capability of this control mode can be 
extended if the transmitting device receives Plot- 
ter responses. Refer to Device to Plotter 
Transmission later in this section for more infor- 
mation. 


Hardware Flagging Mode 


This control mode permits communication at a high 
baud rate, but requires hardware flagging support in 
the transmitting device interface. This mode is enabled 
by the selection of HARDWARE RECEIVE FLAGGING 
on the Communication Control Mode line of the Param- 
eter Entry Card. Advantages of Hardware Flagging 
mode are: 


@ Any available baud rate can be used for small or 
large plots. 


@ No transmitting device support unique to the Plotter 
is required. 


Limitations of Hardware Flagging mode are: 


@ The Plotter and the transmitting device must be 
directly connected unless the communications de- 
vices (such as a modem) are able to pass the RS- 
232-C DTR (Data Terminal Ready) signal. 


@ The transmitting device must be able to suspend 
transmission within 185 characters without loss of 
characters when inhibited by the DTR signal. 


@ Provides parity error detection only with no correc- 
tion of transmission errors. 
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DC1/DC3 Flagging Mode 


This control mode permits communication at high baud 
rates, but requires DC1/DC3 flagging support in the 
transmitting device interface. This mode is enabled by 
the selection of INPUT on the DC1/DC3 Control line of 
the Parameter Entry Card. Advantages of DC1/DC3 
Flagging mode are: 


@ Any baud rate can be used for small or large plots. 


@ No transmitting device support unique to the Plotter 
is required. 


@ Flagging can be done through a modem connection 
to the transmitting device. 


Limitations of DC1/DC3 Flagging mode are: 


@ The transmitting device must be able to suspend 
transmission within 185 characters without loss of 
characters upon receipt of a °3 (stop) character and 
restart transmission upon receipt of a "1 (start) 
character. 


@ Provides parity error detection only with no 
correction of transmission errors. 


Block Mode 


This is a powerful but more complex control mode that 
provides the highest performance in all configurations. 
This mode is enabled when the Plotter receives a 
BLOCK START command. Refer to Block Mode Com- 
munication later in this section for a discussion of 
parameters used with Block mode. Advantages of 
Block mode are: 


@ Any baud rate can be used for small or large plots. 


@ Provides parity and checksum transmission error 
detection. Also provides error correction by retrans- 
mitting blocks of commands. 


Limitations of Block mode are: 


® This mode requires transmitting device software 
support which is unique for the Plotter. Refer to 
Block Mode Communication \ater in this section for 
software packages that have this support. 
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INTERFACE SWITCHING FUNCTION 


The Interface Switching function provides a flexible, 
manual means of selecting the source and destination 
of Plotter data and responses. For example, one can 
modify the connections between devices without hav- 
ing to physically relocate cables. Refer to RS-232-C 
Lines In Loop-Thru Configuration for a discussion of 
the effect of the interface switching function upon the 
RS-232-C lines. 


The Interface Switching function is most useful in the 
loop-thru configuration and is described in respect to 
this configuration. Two front panel switches 
(OFFLINE/ONLINE and LOCAL/REMOTE) on the Plot- 
ter provide four unique conditions for the interface 
switching function as shown in Figure 4-7 and de- 
scribed in the following text. 


Online/Remote 


In this configuration, the Plotter acts as a host 
peripheral when the terminal and Plotter communicate 
with the host (Figure 4-7A). Commands sent from the 
host to the terminal are ignored by the Plotter when it 
has not been turned on with a DEVICE ON command. 


Commands sent from the host to the Plotter are not 
passed on to the terminal if the Plotter is turned on by a 
DEVICE ON command and if the AUTO MUTE selection 
is active on the Parameter Entry Card. In this configu- 
ration, both the terminal and the Plotter can transmit to 
the host. 


NOTE 


The Plotter and terminal should not transmit to 
the host at the same time as the transmitted 
characters could become garbled. 


Online/Local 


The Plotter and terminal communicate while the host 
computer is isolated (Figure 4-7B). This configuration 
switches the Plotter from a host peripheral to a terminal 
peripheral. 


Offline/Remote 


The terminal and host communicate while the Plotter 
remains isolated. (Figure 4-7C). This configuration is 
used to manually mute the Plotter. 


Offline/Local 


Here, no communication occurs between devices 
(Figure 4-7D). The configuration is used mainly for 
troubleshooting because the Plotter, host computer, 
and terminal are isolated from each other. 
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Figure 4-7. Interface Switching Function. 
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RS-232-C LINES IN LOOP-THRU 
CONFIGURATION 


In the loop-thru configuration, the Interface Switching 


function actually switches three RS-232-C signal lines: 


Receive Data (BB), Transmit Data (BA), and Clear-To- 
Send (CB). Other signal lines are passed straight 
through the Plotter from the terminal to the modem. 
These lines are configured so the interface operates 
correctly with either a modem only, a terminal only, or 
both a modem and a terminal connected to tne Plotter. 
Refer to the 4663 Interactive Digital Plotter Service 
Manual for more details. 


The RS-232-C Data Terminal Ready (CD) signal line 
from the Plotter is connected with the Data Terminal 
Ready line from the terminal. Both lines must be 
activated before a ready condition is signaled to the 
host. 


NOTE 


Because the Data Terminal Ready line is not 
switched, the hardware flagging function will only 
provide rate control for devices attached to the 
modem connector. Also, if the Plotter switching 
function is in in LOCAL, the non-switched RS- 
232 control lines still connect the computer and 
the terminal. Thus, a state change in these lines 
may affect the operation of the terminal or of the 
host even though data is not being exchanged. 


For example, a connected modem that is not 

asserting Received Line Signal Detector (CF — 
Data Carrier Detect), will inhibit the Serial inter- 
face even if the switching function is in LOCAL. 


When the Plotter’s POWER switch is set to the off 
position, the Interface Switching function goes into an 
offline/remote state (allowing the terminal and the host 
to freely communicate). Refer to Appendix C for 
definitions of all RS-232-C lines. 
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DEVICE-TO-PLOTTER TRANSMISSION 


The following topics, /nput Buffering, Input Rate Con- 
trols, and Block Mode Communication, help describe 
the transmission of commands from the host computer 
(or data storage device) to the Plotter. The amount of 
data (in the form of commands) continuously transmit- 
ted to the Plotter at a given baud rate is described 
under Input Buffering. The various transmission rate 
control modes used with the Input Buffering function 
(to keep commands from being lost) are described 
under /nput Rate Controls. The information under Block 
Mode Communication, describes the various parame- 
ters and host computer functions involved in block data 
transmission. This information can help in choosing the 
best parameter values for optimum Block mode 
performance. 


Input Buffering 


When commands are received from the host computer, 
they are placed in a temporary buffer in the Plotter’s 
memory. Temporary command storage is required 
when commands are received faster than the Plotter 
can execute them. When the Plotter is ready for 
another command, the stored commands are withdrawn 
from the input storage buffer and executed. The 
following paragraphs describe: 


®@ How the Input Buffering function operates. 


@ How much memory is required to store a Plotter 
command. 


@ How much memory is available under various condi- 
tions for command storage. 


Refer to Input Rate Controls for information on control- 
ling the transmission rate to satisfy input buffering 
constraints described in the following paragraphs. 
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Buffer Operation. Figure 4-8 illustrates a simplified 
model of the Plotter input buffers. All commands are 
received as a series of ASCII characters and are 
entered into the Input Character Buffer (Buffer A) at the 
rate the characters are read from the Plotter’s com- 
munication hardware. The stored characters are then 
retrieved from Buffer A and converted into a 
corresponding internal command form. Any Interface 
commands are executed at once (refer to the Serial 
Interface Commands section for a listing of these 
commands). 


All other commands are stored in the Input Command 
Buffer (Buffer B). When the Plotter is ready for another 
command, these stored commands are retrieved from 
Buffer B and executed. The Plotter processes Buffer A 
characters into commands while it is (1) waiting for the 
current pen carriage motion of the Plotter to be 
completed, and (2) while it is not servicing the interface 
hardware. Thus, the rate at which characters are 
removed from Buffer A depends upon the plot in 
process and the rate at which characters are being 
received by the Plotter. 


PLOTTER 


PLOTTER 


SYSTEM 
INTERFACE 


COMMAND 
EXECUTION 


HARDWARE 
INTERFACE 


Commands can be sent to the Plotter in bursts (which 
do not exceed the capacity of the Input Character 
Buffer) until Buffer B is full. Buffer A is of fixed size and 
can contain up to 248 characters, with each character 
requiring one byte of storage. For high baud rates 
(greater than 2400 baud), the command characters 
usually arrive from the host faster than they can be 
formed into internal commands. Thus, for these baud 
rates, the maximum size of a continuous burst of 
characters sent (including any padding characters, 
such as “Nu (NUL), Sy (SYN), and °+ (DEL)) must be less 
than 248 characters. If the number of padding charac- 
ters added by the host output is hard to determine, use 
a maximum of 200 to 225 characters. 


For moderate baud rates (600 to 2400), transmitted 
characters are normally formed into commands faster 
than the Plotter receives them. Thus, Buffer A overflow 
is not a consideration and commands can be received 
until the capacity of Buffer B is exceeded. For low baud 
rates (50 to 300), commands are normally executed 
faster than they are received, and the buffering func- 
tion is not active. The input rate controls, discussed 
later in this section, allow command transmission to the 
Plotter to be controlled by the input buffering con- 
straints. 


N 


HOST 
COMPUTER 





Figure 4-8. Input Buffering Model. 
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Storage Requirements for Commands. All commands 
are received by the Plotter in various forms of Style | 
and Style Il commands. These command formats are 
described under /ntroduction To Serial Commands and 
Responses, later in this section and should be referred 
to if you are not familiar with Style | and Style I! 
formats. 


The internal form into which Style | Plotter commands 
are converted requires the following storage for the 
Input Command Buffer: 


® Two bytes of storage for each command code, plus, 
@ One byte of storage for each character argument, 


e@ And five bytes of storage for each numeric 
argument. 


For commands with string arguments, a separate 
command is formed for each string character. For 
commands with a command code followed by multiple 
groups of arguments, a separate command is formed 
for each argument group. 


The internal form into which Style II Plotter commands 
are converted requires the following Input Command 
Buffer storage: 


@ Three bytes of storage for each PRINT or Attention 
Action command. 


@ Twelve bytes of storage for each MOVE, DRAW, 
CIRCLE, or POINT command. 


@ Twenty four bytes of storage for each ARC com- 
mand. 


The internal form for each command is the same 
regardless of the command format used to transmit the 
command to the Plotter. This means for some cases 
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that more bytes of memory are needed for a command 
stored in the Input Command Buffer than it took 
characters to transmit the command to the Plotter. The 
ratio of these respective number of characters is 
defined as the internal expansion factor. The following 
examples show some different internal expansion 
factors: 


@ Atypical Style | PRINT command, such as £c A P 
“*X”, takes six bytes to express and three bytes 
to store, giving an internal expansion factor of 0.5. 


@ A Style || PRINT command takes one character to 
express and three bytes to store, giving an internal 
expansion factor of 3.0. 


@ Atypical Style | DRAW command, such as Fc A Y 
100,10 takes nine bytes to express and twelve 
bytes to store, giving a 1.33 internal expansion 
factor. 


@ Atypical Style Il DRAW command (for twelve-bit 
graphics) takes five bytes to express and twelve 
bytes to store, giving an internal expansion factor of 
2.4, 


@ Atypical Style || DRAW command (for ten-bit 
graphics) takes four bytes to express and twelve 
bytes to store, giving an external expansion factor of 
3.0. 


@ The worst case is an optimized Style Il DRAW 
command that may, for a short vector, reduce to one 
character (again requiring twelve bytes to store), 
giving an internal expansion factor of 12. 


Further reference to the internal expansion factor 
occurs under Block Mode Communications, later in 
this section. 
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Memory Limits for the Input Command Buffer. The 
Plotter memory available for buffer operation is used in 
two ways: First, some memory always establishes a 
minimum size for the Input Character Buffer and the 
Input Command Buffer. Second, the remaining memory 
is used on a “first come, first served” basis for (1) the 
expansion of the Input Command Buffer to store more 
input commands, (2) the temprorary buffering of re- 
sponses formed by “output generating commands”, 
and (3) providing longer term storage for the following 
types of data: 


@ Graphic transform levels saved by a SAVE CUR- 
RENT TRANSFORM command. 


@ Programmable macros defined by Macro commands. 
(Option 31). 


@ Downloadable characters defined by Downloadable 
Character commands (Option 32). 


Refer to individual command descriptions to determine 
the amount of memory space required for data storage. 
If memory space is unavailable, the Plotter attempts to 
temporarily inhibit the transmitting device from sending 
more commands using the Current rate control method. 
If further commands are received before memory is 
available, the commands will be lost and an error 
reported on the Plotter. When stored data is 
subsequently deleted, the allocated memory becomes 
available again for other uses. 


NOTE 


When a buffer overflow error occurs, several 
commands are usually lost during recovery from 
the error. 


While a programmable macro or downloadable charac- 
ter is being defined, or if most of the available memory 
has been used to store programmable macros or 
downloadable characters, the Input Command Buffer is 
forced to assume its minimum size. The number of 
commands stored while in this minimum size depends 
upon the command type. For example, about 200 
PRINT CHARACTER commands or about 50 MOVE and 
DRAW commands could be stored. The number of 
external characters required to define these commands 
depends upon the command style being used. If no 
transforms, programmable macros, or downloadable 
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characters are stored, and no output responses are 
stored, then the Input Command Buffer can expand toa 
maximum size. In a standard Plotter with 8K bytes of 
memory, about 340 MOVE and DRAW commands or 
1360 PRINT CHARACTER commands could be stored. 


NOTE 


The Plotter’s Input Character and Input Command 
Buffers are cleared if the interface is initialized by 
the front panel Initialize function. 


Input Rate Controls 


Input rate controls allow the Plotter to control the rate 
at which it receives commands from the host, terminal, 
or a data storage device. This control prevents data 
loss when the Plotter is unable to keep up with 
incoming commands and when the capacity of the 
input buffers is exceeded. Four input rate control 
modes are used with the Plotter; Continuous mode, 
Hardware Receive Flagging mode, DC1/DC3 Flagging 
mode, and Block mode. The following describes the 
operation of the various rate control modes in respect 
to the input buffering function. A brief summary of 
these modes can be found under Selecting A Commu- 
nications Contro! Mode, located earlier in this section. 


Continuous Mode. Continuous mode provides only 
passive rate control and is the default communications 
mode for the Plotter during the following conditions: 


@ After Plotter power-up or a front panel Initialize 
function if a flagging mode has not been selected on 
the Parameter Entry Card. 


@ After a DEVICE ON command has been received. 


Rate control is accomplished by selecting a host-to- 
Plotter input baud rate that transfers commands to the 
Plotter only at the rate the commands can be pro- 
cessed or stored. For short plots (less than 350 graphic 
commands), baud rates up to 2400 can be used. For 
large plots, baud rates of 300 or less are normally 
required. Commands arriving faster than they can be 
processed are stored in the Plotter as long as memory 
is available. Received commands exceeding memory 
storage capabilities are lost and an error is reported. 
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Active host support is not required for Continuous 
mode and no unique control operations are performed. 
Thus, Continuous mode can be used with data storage 
devices not having active control capabilities. 
Continuous mode is useful for plotting commands that 
are generated for a terminal and contain no Block 
mode rate control commands for the Plotter (such as 
4010 Series Style Il commands). 


If the plot (1) stores several levels of graphic trans- 
forms, (2) stores programmable macros, or (3) stores 
downloadable characters, then the receive baud rate 
should be reduced to keep the input buffer size toa 
mimimum while macro or downloadable character 
definitions are taking place. 


Parity Error detection or loss of carrier monitoring are 
the only transmission error functions available and, 
with this mode, error correction is unavailable. 


If the transmitting device is able to receive Plotter 
responses, Continuous mode operation may be extend- 
ed. For example, if an output generating command 
(such as READ STATUS) is sent to the Plotter after a 
block of commands, the reception of the Read Status 
back from the Plotter informs the transmitting device 


, that the input buffer is empty and another block of 


commands can be sent. This allows operating at higher 
baud rates and sending plots of arbitrary length. 


Hardware Receive Flagging Mode. This mode is used 
only to control devices attached to the modem connec- 
tor. Hardware Receive Flagging mode permits any 
available baud rate for host-to-Plotter transmission to 
be used. This can be done without concern that a given 
baud rate is too high for a particular plot operation. 


Hardware Receive Flagging mode requires that the 
host's input/output port be able to suspend 
transmission without loss of data when inhibited by the 
RS-232-C signal line Data Terminal Ready (CD). This 
This restricts the Plotter to a directly connected host 
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unless a modem that is capable of passing the Data 
Terminal Ready signal to the host is used. Some data 
storage peripherals can operate in this mode for offline 
plotting. This mode is also used for plotting commands 
that are generated for a terminal and contain no Block 
mode rate control commands for the Plotter (such as 
4010 Serial Style | commands). 


The Hardware Receive Flagging mode is enabled by 
selecting HARDWARE RECEIVE FLAGGING on the 
Communications Control Mode line of the Parameter 
Entry Card. 


When operating in Hardware Receive Flagging mode, 
commands are received at the selected baud rate and 
stored as in Continuous mode. If commands are being 
received faster than they can be processed, the input 
buffer will fill up. When the Input Character Buffer is 
about 185 characters from being full, the RS-232-C 
control line Data Terminal Ready is deactivated to 
notify the host to stop transmitting. The host computer 
is then allowed to slow to a stop by completing the 
transmission of the current line or output buffer. 
However, transmission should stop within the 185 
character limit. 


The Plotter then continues to perform commands until 
the Input Character Buffer is almost empty. The Data 
Terminal Ready line is then reactivated to notify the 
host that data transmission may resume. 


NOTE 


At high baud rates, the Input Character Buffer 

may fill up, causing flagging to occur even though 
the Input Command Buffer is not full. (Refer back 
to Buffer Operation, in this section.) This action 
occurs because commands cannot be processed 
into the Input Command Buffer fast enough even 
if there is room to store the commands. Thus, 
more flagging action can occur at high baud 
rates. 
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DC1/DC3 Flagging Mode. DC1/DC3 Flagging mode 
operation is identical to the Hardware Receive Flagging 
mode with the exception that an ASCII 93 (DC3) control 
character (stop) is sent to the host to suspend data 
transmission, and an ASCII 91 (DC1) control character 
(start) is sent to the host to resume transmission. The 
D; and 93 contro! character functions replace the Data 
Terminal Ready line operation described for Hardware 
Receive Flagging. In this mode, the host input/output 
port must be able to suspend data transmission without 
data loss when it receives the 9s, and restart again 
when the "1 character is received. 


Because the flagging is done with characters rather 
than with control lines, this mode can control devices 
attached to either the terminal or a modem connector. 
Some data storage peripherals can operate in this 
mode. This mode is useful for plotting commands that 
were generated for a terminal and contains no Block 
mode rate control commands for the Plotter (such as 
4010 Series Style Il commands). 


DC1/DC3 Flagging mode is enabled by selecting 
INPUT on the DC1/DC3 Control line of the Parameter 
Entry Card. 


NOTE 


lf a communications error causes a DC1/DC3 
character to be garbled in transmission, the 
handshake involved with the host computer 
causes computer communications to stop. If this 
occurs, (1) manually interrupt transmission of 
commands from the the host computer, (2) 
reinitialize the Plotter using the front panel Initial- 
ize function, and (3) restart command transmis- 
sion. 


Block Mode. Block mode provides rate control, error 
detection, and error correction. Block mode is used in 
any communications environment as no special 
hardware or communications support is required. How- 
ever, several host computer functions that need soft- 
ware support are required. These functions and the 
methods for selecting values for their related parame- 
ters are discussed in the Block Mode Communications. 
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In Block mode communication, the host computer 
divides the commands (to be sent to the Plotter) into 
blocks of characters and sends these blocks, one ata 
time, to the Plotter. After each block is transmitted, the 
host pauses for a response from the Plotter. When the 
Plotter receives a block, the input buffer is examined 
for space to store another block. If there is sufficient 
memory, a positive acknowledge character (an ASCII 
A) is sent to the host to enable transmission of the next 
block. (Refer to Plotter-to-Device Transmission for a 
discussion on controlling the output of the acknowl- 
edge character, 


If insufficient space exists in the input buffer, the 
transmission of the acknowledge character is deferred 
until sufficient Plotter commands are executed to make 
the required space available. This action matches the 
effective input baud rate to the rate at which the Plotter 
processing takes place regardless of the selected input 
baud rate. 


Each block begins with a BLOCK START command and 
is terminated by a BLOCK END command. The BLOCK 
END command includes a checksum computed from 
the contents of the block. When the Plotter receives a 
block, this checksum is recomputed and evaluated. If 
the recomputed checksum does not match the check- 
sum in the BLOCK END command, (indicating a 
transmission problem), the block is discarded and, if 
sufficient memory is available to hold the block, a 
negative acknowledgement character (an ASCII I) is 
transmitted to the host. The host then retransmitts the 
block and the checksum is evaluated again. This 
process provides a means of error detection and error 
correction (by sending the data again). If the erroris a 
persistent one, the host will usually abort the 
transmission after a few attempts. 


NOTE 


lf acommunications error causes a BLOCK 
START command, a BLOCK END command, or a 
block acknowledge character to be garbled in 
transmission, the handshake involved with the 
host computer will cause computer communica- 
tions to stop. If this occurs, (1) manually interrupt 
the command transmission from the host, (2) 
reinitialize the Plotter with the front panel Initial- 
ize function, and (3) restart command tranmis- 
sion. 
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This communications mode requires the host computer 
to perform four related functions: grouping the Plotter 

a commands into blocks, computing a checksum for the 
block, transmitting the block, and processing the 
resultant block acknowledge character. 


— The following paragraphs describe how to determine 
what Block mode blocksize to use under various 
conditions. Also described are procedures for 
assembling Block mode blocks, computing the block 

= checksum, and then using Plotter commands to control 

Block mode communications. If Tektronix host software 

support is not used, these procedures must be imple- 

mented in a user-written support package containing 


_ Block mode host software. In addition, there is a brief 
description of the available Tektronix host support that 
can be used with the Plotter. 

] 

Maximum Blocksize. Information here describes how 
to determine the optimum size of the blocks to be used 

- for Block mode communications. A summary of block- 
sizes at the end of this topic provides conservative 

~~ blocksize values that can be used when optimum 
values are not desired. 

a 


You must specify the maximum blocksize to the Plotter 
using a SET BLOCK SIZE command before initiating 
Block mode. After a block is received from the host and 

~ before an acknowledge character is returned (to allow 
the next block to be transmitted), the current maximum 
blocksize value is checked to see if another block of 
this size can be stored. 


) 
If a blocksize is not specified, a value of “O” is 
assumed, which disables the check for available input 
| buffer space (and, therefore, the rate control function). 


The number of command characters contained ina 
block between the BLOCK START and BLOCK END 
commands should be not greater than this specified 

onl value. The ASCII characters — Nu (NUL), Sy (SYN), and 
D+ (DEL if the Parameter Entry Card’s DEL IGNORE 
selection is active), or the command delimiters ‘;” and 
Cr (when the Command/Response Format is 1 or 2) — 

- need not be included in the count. The actual size of 
the block transmitted may be any value less than or 
equal to this size. 
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If possible, a blocksize should be specified that is smail 
enough to allow some communications overlap. Com- 
munications overlap means that one Block mode block 
is being received while the commands in the previous 
block are being executed. This procedure provides a 
continuous flow of commands to the Plotter. However, 
communication overlap requires that the blocksize be 
less than one-half the input buffer size (to ensure 
space is available in time to receive the next block 
before the commands in the current block are 
executed). 


The maximum blocksize that may be specified when 
communicating with a standard Plotter (with 8K bytes 
of memory) is approximately 1,020 characters assum- 
ing an average internal expansion factor of 4. (For 
example, it usually takes four times as many input 
buffer bytes to store the internal form of the commands 
as it takes characters in a Block mode block to 
transmit the command. Refer back to /nput Buffering 
earlier in this section for a discussion of the internal 
expansion factor.) 


NOTE 


Use of large blocksizes can disable any commu- 
nications overlap. Also, in difficult communica- 
tions environments where characters are 
frequently garbled and blocks must be retransmit- 
ted, smaller blocksizes should be used to keep 
the pen in motion. 


When the maximum blocksize value is used to deter- 
mine if enough memory exists for the next block, an 
average expansion factor of 4 is assumed. This 
assumption is sufficient for most plotting. However, 
there are applications where this assumption is not 
accurate enough and compensation must be made. 
One example that allows optional compensation is 
when the plot commands consist almost entirely of 
PRINT CHARACTER commands. Here the average 
expansion factor is actually 3 and allows the host 
computer to optionally send blocks that are one-third 
larger than the specified maximum blocksize. However, 
the maximum blocksize is still about 1020 characters. 
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Another extreme that requires compensation occurs 
when optimized Style II commands are sent that 
include many short vectors, (as in a graphing or 
contouring application). Here, the internal expansion 
factor could be as great as 12, which means the actual 
blocksize transmitted should be no more than one-third 
of the maximum blocksize specified in the SET BLOCK 
SIZE command. This reduces the maximum blocksize 
to about 340 characters. 


For many applications, the blocksize value does not 
have to be precisely specified. If the block expands 
less than expected, a temporary loss of buffering 
capacity is the only result. If the block expands more 
than expected and overflows the available buffer 
space, the block is discarded. Then the actual size of 
the block (rather than the specified maximum size) is 
used to determine when sufficient buffer space is 
available. Once the space becomes available, the 
Plotter sends a negative acknowledge character to 
initiate retransmission of the block. However, if pro- 
grammable macros or downloadable characters are to 
be defined, close attention must be paid to the 
maximum blocksize specification. 


During definition of a programmable macro or a 
downloadable character, the input buffer is forced to a 
minimum size to make the most memory available for 
macro or character storage. This minimum buffer size 
accomodates a maximum blocksize of 150 characters 
assuming an internal expansion factor of 4. There 
would be no communications overlap unless the 
blocksize is less than 75 characters. As noted earlier, if 
the internal expansion factor is 12 (for optimized 4014 
short vector graphics), minimum buffer size operation 
reduces the maximum blocksize to 50 caracters. 
Blocks that expand more than specified (or expected) 
can normally be accomodated if there is additional 
memory that has not been filled with macro or charac- 
ter storage. Blockmode communications may fail if a 
large portion of the available memory is used to store 
macros or downloaded characters and the blocksize 
and expansion factor constraints listed above are not 
observed. 


When SAVE CURRENT TRANSFORM commands are 
sent to the Plotter, care must be taken that sufficient 
memory exists to store each transform (a transform 
requires about 30 bytes for storage). One or two 
transform levels are always available under all condi- 
tions (even if the memory is full of programmable 
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macros or downloadable characters). If several levels 
are to be saved, then pausing or sending a READ 
STATUS command after the SAVE CURRENT TRANS- 
FORM command would ensure that the input buffer is 
of minimum size and that maximum memory is available 
to store the transform levels. 


For operation at high baud rates (greater than 2400 
baud), the buffering constraints dictate that the 
maximum burst of character size transmitted to the 
Plotter (including the BLOCK START and BLOCK END 
commands and the total number of characters within 
the block where Nu (NUL), Sy (SYN), and % (DEL) 
padding characters are included) must be less than 
155. (Refer to Input Buffering earlier in this section) 
Therefore, when using high baud rates (greater than 
2400 baud), the recommended maximum Block mode 
blocksize should be 155 characters minus the 
expected number of padding characters. 


NOTE 


Either Hardware Receive Flagging mode or 
DC1/DC3 Flagging mode can be used with Block 
mode communications to avoid Input Character 
Buffer overflows. This permits using larger block- 
sizes even at high baud rates. 


The requirements for maximum blocksize are summar- 
ized as follows (with more restrictive operation using a 
smaller blocksize): 


@ Standard maximum blocksize is less than 1020 
characters. 


@ Use a maximum blocksize of 155 characters if: 


(1) the majority of memory is filled with programm- 
able macros or downloadable characters, or if 


(2) the baud rate is greater than 2400 baud. 


®@ If communications overlap is desired, reduce 
blocksizes listed above by one-half. 


@ If Plotter commands are mostly Style Il PRINT 
commands, increase standard blocksize by one- 
third. 


@ {f Plotter commands are mostly optimized Style II 
MOVE or DRAW commands that specify short 
motions, reduce standard blocksize by two-thirds. 
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Block Contents. Blocks may include any Plotter 
command except DEVICE ON, DEVICE OFF, or DEVICE 
RESET. However, interface commands should not be 
included in a block. These commands would be 
executed as soon as they were recognized by the 
interface, but they cannot take effect in time to control 
the transmission of the acknowledge character for that 
block. Therefore, the interface commands used to 
establish communication parameter values should be 
transmitted in Continuous mode before initiating Block 
mode. 


Include only complete Style | commands in a command 
block. (For example, BLOCK START or BLOCK END 
commands cannot appear within other Style | com- 
mands). Style Il commands may include Style | com- 
mands and thus be split between two blocks. Refer to 
Introduction to Serial Commands And Responses for 
more discussion of Style | and Style Il commands. 


Block Mode Checksum. The checksum contained in 
the BLOCK END command is computed by adding each 
7-bit character of the block into a 12-bit accumulator 
with an end-around-carry of any overflow. The block 
characters included in the checksum extend from and 
include the “(” in the BLOCK START command to the 
“)” in the BLOCK END command, as shown in 

Figure 4-9. 


All block characters contained between the BLOCK 
START and BLOCK END commands are included in the 


BLOCK START Command 


Ar Ap ( 


Plotter Commands 


Characters ecececce 
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checksum, except for the following: 
@ The Nu (NUL) character. 


®@ The Sy (SYN) character unless the Sy character has 
been selected on the ATTENTION CHARACTER line 
of the Parameter Entry Card. 


@ The ° (DEL) character if the DEL IGNORE has been 
selected on the Interface Functions Line on the 
Parameter Entry Card. This allows systems that use 
D. characters for padding to be accomodated. An 
At ? character sequence should be substituted for 
the °_ character in Style Il commands if this 
selection is made. 


@ Any "1 or °3 characters. 


The 12-bit accumulator is initially set to “O”’. If the 
addition of a 7-bit character causes the accumulated 
value to exceed 4095 (the maximum 12-bit number), 
4095 (—4096+ 1) is subtracted from the accumulated 
value to accomplish an end-around-carry from the 12th 
bit. When all characters have been added, the check- 
sum value is converted to an ASCII decimal number 
and transmitted as a BLOCK END command argument. 
When the block is received by the Plotter, the 
checksum is recomputed using the same procedure. 
After the “)” character has been added, the checksum 
value should be the same as the checksum value 
transmitted from the host. If a value of “O” is specified 
for the checksum, the checksum error detection func- 
tion is disabled and a positive acknowledge is auto- 
matically generated. 


BLOCK END Command 


Ar Ap ) checksum 


ASS SS 


Included in Checksum 





Figure 4-9. Block Mode Checksum. 
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Turning Block Mode On and Off. Described here are represents an interface state where certain processing 
procedures for enabling and disabling Block mode steps (described later) are performed on the received 
communications. Figure 4-10 is a state transition commands. Each arc connecting the circles represents 
diagram that illustrates the relationship between Block a change of state when the specified command is 
mode and Continuous mode. Each circle in the diagram received. 





Figure 4-10. Communications Mode State Diagram. 
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NOTE 


Hardware Receive Flagging mode and DC1/DC3 
Flagging mode are not included in this diagram. 
This is because the two flagging modes operate 
independent of Block or Continuous mode. 


Continuous mode automatically occurs at Plotter 
power-up or when a front panel Initialize function is 
selected. Continuous mode is represented by the 
Plotter On and Plotter Off states. In the Plotter On state, 
commands are recognized and executed as they are 
received. 


lf a BLOCK START command is received, Block mode 
communication is initiated (the In Block and Between 
Blocks states). Communication continues in Block 
mode until either a DEVICE ON or DEVICE OFF 
command is received or the interface is reinitialized. 
While in the In Block state, the interface recognizes the 
commands, stores them in the input buffer (without 
executing them), and accumulates the checksum. 


After the BLOCK END command is received, the 
checksum is verified and the positive or negative 
acknowledge character is generated. If the acknowl- 
edge was negative, the stored commands are discard- 
ed. }f the acknowledge was positive, the commands are 
executed. While in the Between Blocks state, all 
characters and commands except the Bypass Cancel 
character, the prompt string (see Plotter-To-Host Com- 
munications), and the DEVICE ON, DEVICE OFF, or 
BLOCK START commands, are ignored. This state 
allows the interface to ignore any unexpected 
characters transmitted by the host between Block 
mode blocks. 


Existing Plotter Support Software. Several host 
support software packages are available from Tektron- 
ix and can be installed on most host computers to 
manage Block mode communications as well as pro- 
vide other Plotter and terminal support functions. 
These are components of the TEKTRONIX PLOT 10 
Graphics Library. These packages provide capabilities 
from simple graphing to state-of-the-art graphics. A set 
of utility routines interface these packages to the 
Plotter. For further information about these software 
products, contact the local Tektronix sales office. 


4663 PROGRAMMER’S REFERENCE 


SERIAL INTERFACE 
COMMUNICATING WITH OTHER DEVICES 


PLOTTER-TO-DEVICE TRANSMISSION 


The Plotter transmits several types of information to the 
host computer in response to Plotter commands. The 
following paragraphs discuss the transmission of out- 
put information, including: 


@ How output blocks are generated. 


@ How the host can identify the output blocks that are 
received. 


@ How output biocks are stored and grouped into 
messages for transmission. 


® How initiation of the output transmission is con- 
trolled for compatibility with the host computer. 


@ How the output transmission rate is controlled. 


® How the Plotter bypass function disposes of output 
message characters echoed by the host. 


Output Blocks 


The Plotter generates two classes of outputs: commu- 
nications control information and data generated in 
response to Plotter commands. Each of these output 
classes, the forms in which they are transmitted, and 
the priority of their transmission are described in the 
following paragraphs. 


One type of communications control information is the 
DC1/DC3 characters required for DC1/DC3 flagging 
rate control. This information is transmitted as single 
characters rather than as output blocks. Another type 
of communications control information is the Block 
mode acknowledge characters. These characters are 
transmitted as special output blocks consisting of only 
the acknowledge character. 


The other class of Plotter output (responses generated 
by Plotter commands) is transmitted as one or more 
output blocks. Each output block contains two numeric 
response values plus a TAG value. For commands 
whose response consists of one value (such as READ 
FORM LENGTH), or two values (such as DIGITIZE) only 
one output block is generated. For commands that 
return more than two response values, two or more 
output blocks are generated. If a response requires 
only one numeric value, the other value is set to “0”. 
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The TAG value is the third numeric value generated 
along with response values. For Command/Response 
Formats 1 and 2, the TAG value may indicate an 
additional characteristic of the two response values, as 
well as a LAST block, a NOT LAST block, or CONTROL 
designation for the block. The meaning of any 
additional characteristics are defined for each com- 
mand response. For example, the coordinate values in 
a response biock generated by a DIGITIZE command 
may be designated as the end point coordinates of a 
Move or a Draw. 


The TAG value designations for different types of 
blocks are: 


@ CONTROL for Block mode acknowledge output 
blocks (the only control block defined). 


® LAST BLOCK for single block responses or for the 
last block of a multiple block response. 


@ NOT LAST for all other response blocks. 


For Command/Response Formats 3 and 4, the TAG 
value uniquely identifies the response block in terms of 
the initiating command. Refer to Output Responses 
near the end of this section for more information on 
TAG values for all Command/Response Formats. 


The size of these response blocks can vary from 7 to 
33 characters, depending upon the current Com- 
mand/Response Format and the numeric values of the 
responses. Refer to the command description sections 
for a discussion of response value formats set up for 
each response block and the accompanying TAG 
values. 


Groups of output blocks sent to the host are referred to 
as output messages. Each output message consists of 
three parts, which must be transmitted in the following 
order: 


1. Asignature character (if one has been defined via 
a SET SIGNATURE CHARACTER command). 


2. The response blocks ready to be transmitted 
followed by a control block (if any). 
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3. One or two output termination characters depend- 
ing upon the selection made on the Output 
Terminator line of the Parameter Entry Card. 


The actual coding of the responses and the actual 
characters transmitted in the output message depend 
upon the current selection of the Command/Response 
Format. 


Output Block Identification 


When the host receives an output response block, you 
must identify the response and associate it with the 
output generating command that created the response. 
If a single output generating command has been sent, 
identification is easy. If multiple output response 
blocks are received, refer to the following guidelines to 
help identify the output generating commands. 


@ For Command/Response Formats 1 and 2, response 
blocks are unlabeled (the response block itself does 
not indicate the command that generated it, for 
example, a READ FORMLENGTH command or a 
DIGITIZE commana). Thus the order in which re- 
sponses are received is critical. 


@ Output responses are always generated in the order 
that the generating commands were received (with 
the exception of Block mode acknowledge re- 
sponses, which are generated before responses to 
commands within a block are generated). In addition, 
all blocks of a multiple block response are generat- 
ed before any other command responses are 
started. 


@ ATAG value of LAST is always present in the last 
block of a response. 


@ For Command/Response Formats 3 and 4, the 
response blocks are labeled and can be easily 
identified by their TAG values. 


@ The use of a unique signature character permits the 
host to identify the source of response blocks when 
multiple plotters are being used. 
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Output Buffering 


As the Plotter’s outputs are generated, each output is 
stored until all transmission constraints are satisfied. 
These contraints are discussed in more detail later in 
this section, Only one flagging control character and 
one Block mode acknowledge character can be ready 
for transmission at any one time. For that reason, they 
are stored as individual pieces of data. However, 
multiple response blocks can be ready and stored in 


the Plotter’s output buffer until transmission is initiated. 


NOTE 


The memory utilized to store output responses 
reduces the amount of memory available to store 
commands in the input buffer, programmable 
macros, downloadable characters, and trans- 
forms. Therefore, buffering of output responses 
should be kept to a minimum. 


Normally the host waits for the response of one output 
generating command to be returned from the Plotter 
before sending another output generating command 
(although several outputs can be generated and re- 
turned to the host together). Enough memory is re- 
served for output storage so that a single response 
block can always be buffered even if all the remaining 
memory has been allocated to other functions. Up to 
127 response blocks may be stored if memory is 
available. 


The amount of buffer space required to store 
responses is the sum of the number of bytes in each 
response block plus one byte per response block. 


Because memory is allocated to buffering functions in 
62-byte increments, the amount of memory required to 
store this number of bytes is determined by rounding 
the number of bytes up to the nearest multiple of 62. 
The output buffer is cleared whenever a front panel 
Initialize function is performed. 


Formation of Output Messages 


The way in which types of buffered output are returned 
to the host are determined by two considerations: the 
priority of the output and any possible limitations of the 
host computer in receiving the response. 


The buffered output blocks are grouped into appropri- 
ate output messages to satisfy these considerations. 
This output can consist of DC1/DC3 control charac- 
ters, control blocks, or response blocks. 
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DC1/DC3 flagging contro! characters have the highest 
priority for transmission from the Plotter. Because the 
host computer continually scans for the DC1/DC3 
characters, the Plotter can transmit them at any time 
regardless of any current output activity. When 
transmission is not in process, the flagging character 
will be transmitted immediately, ignoring any output 
initiation constraints. When transmission is currently in 
process, the flagging character will be the next charac- 
ter transmitted, even if this places the character within 
an output block. The signature character or the output 
termination characters are not added to the flagging 
characters when they are transmitted. 


The next higher priority is any pending control block 
(Block mode acknowledge character). A pending con- 
trol block is always contained in the next output 
message sent when the output initiation constraints are 
satisfied. 


NOTE 


The Block mode acknowledge character generat- 
ed when a BLOCK END command has been 
received by the Plotter is always transmitted 
before any responses that are generated by 
commands contained within the block. 


Some line-oriented host computers store only incoming 
data and inhibit processing until an output (End-of- 
Line) terminator is received. As the block containing 
the Block mode acknowledge character is a control 
block, the information needs to be processed quickly 
and is always followed by the currently defined Output 
Terminator characters selected on the Parameter Entry 
card. These characters define the end of the output 
message. 


The lowest priority is the transmission of pending 
response blocks. When the higher priority messages 
have been transmitted, any pending response blocks 
are formed into messages and transmitted when the 
output initiation constraints have been satisfied. 


Many host computers also have limitations on the 
length of the line received. Thus, when transmitting 
output responses, the output termination characters 
are inserted after the appropriate number of response 
blocks so that a single output message will contain no 
more than 62 characters (including the output 
termination characters). This is a maximum line length 
value acceptable to most host computers. 
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Output Initialize 


In many cases, due to hardware or software limitations, 
the host computer can only receive responses from the 
Plotter when it is in a ready-to-read state. This case 
can occur even if the Plotter is connected to the host 
via a full duplex communication line. Responses trans- 
mitted to the host computer at other times could be 
lost. Two output initialize mechanisms are available in 
the Plotter to control initializing response transmis- 
sions to ensure that the host is ready to read. These 
are the Turnaround Delay function and the Prompt 
function. Either one or both functions may be required 
to match the Plotter to the requirements of a particular 
host. Once these mechanisms are satisfied, transmis- 
sion is initiated and continues until a complete output 
meassage (ending with the current output termination 
characters) has been transmitted. 


Turnaround Delay Function. This function accommo- 
dates host computers that are not able to read for a 
short interval after each time they transmit. The 
Turnaround Delay function is enabled when the SET 
TURNAROUND DELAY command changes the Turnar- 
ound Delay value to a number greater than O. This 
function forces software half duplex operation so the 
host computer must stop transmitting for a time equal 
to the Turnaround Delay before the Plotter can initiate 
transmission. Each time any characters (including 
padding characters) are received from the host, the 
time period is restarted. This time period allows the 
host software to switch from Send mode to Receive 
mode. 


Some host computers cannot read for a short period 
after they receive an output (End-of-Line) terminator. 
The Turnaround Delay function also accommodates 
this restriction by inhibiting the start of transmissions 
of a following output message (for the Turnaround 
Delay period) after the previous output message has 
been transmitted, even if all other transmissions have 
been satisfied. 


Prompt Function. The second mechanism controlling 
output initiation is the Prompt function. Here, prompts 
accommodate host computers that exhibit a varying 
time period between the end of a host transmission and 
when the host is ready to receive information. This 
function is enabled when the SET PROMPT STRING 
command changes the prompt string to a non-null 
value. The Prompt function is used when communicat- 
ing with host computers that transmit one or more 


prompt characters to indicate they are ready to receive. 
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The prompt strings can be up to four characters long 
and contains any ASCII characters. These characters 
must be received successively to be recognized (for 
example they must not be separated by other charac- 
ters such as the Nu, Sy, or °. padding characters). The 
Plotter scans all characters received from the host for 
a prompt string when one or more output generating 
commands have been received and not all generated 
output has been transmitted. When a prompt string is 
recognized, the string characters are deleted from the 
Plotter input (that is, they are not processed as 
command characters). 


The prompt string is not recognized within a block 
during Block mode. The Plotter recognizes a prompt 
string whenever prompt scanning is enabled. However, 
only one prompt string at a time is recognized because 
prompts cannot be queued up. Only after initiating 
transmission of the corresponding output messages 
will the next prompt be recognized. 


Remember that BLOCK END commands (which allow a 
block acknowledge to be generated) and OPERATOR 
DIGITIZE ENABLE commands (which allow the 
operator to generate digitize response blocks) are 
included in the output generating commands category. 


Command/Response Formats 3 and 4 allow the OPER- 
ATOR DIGITIZE function to be permanently enabled. 
This permits digitize response blocks to be generated 
without a corresponding output generating command to 
enable the prompt scan. For these formats, the 
PROMPT LIGHT ON command can be used to enable 
the prompt scan if operator digitized output is expected 
but not yet generated. The prompt scan is enabled only 
by an external PROMPT LIGHT ON command and 
disabled by a PROMPT LIGHT OFF command. Other 
Plotter functions may turn off the Prompt light, but they 
will not disable a prompt scan. 


Combined Output Initialize. A combination of the 
Turnaround Delay and the Prompt mechanisms allow 
constraints of most host computers to be accommodat- 
ed. If a Turnaround Delay or Prompt string is not 
defined, then the host computer is assumed to have full 
duplex capability and transmission is started for each 
output block as soon as it is generated. Thus, each 
block constitutes an output message and is terminated 
by the current output termination characters. 
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If a Turnaround Delay or a Prompt string is defined, 
then software half duplex operation is assumed and the 
output blocks are buffered until the transmission 
constraints are satisfied and transmission can be 
started. For example, the host has transmitted the 
Prompt string and has stopped transmitting for the 
Turnaround Delay period. 


As an example, the Plotter is communicating with a 
host under software half-duplex constraints and has 
received a Block mode block containing a READ 
STATUS command and a DIGITIZE command. The 
following sequence of events can occur: 


1. The block is processed and its checksum verified. 


2. If OK, a positive Block mode acknowledge control 
block is generated. 


3. When the Prompt string has been received from 
the host computer and the Turnaround Delay has 
expired, the control block is transmitted as an 
output message followed by any current output 
termination characters. 


4. Atthe same time, the commands within the block 
are processed, and the two command response 
blocks are generated. 


When the next Prompt string is received from the 
host and the Turnaround Delay has again expired, 
the two response blocks are transmitted as an 
output messaqe. 


e If the host computer responded quickly with the 
second prompt before the second response- 
generating command was processed, the output 
message might contain only the first response 
block, and thus require another prompt from the 
host computer to cause both responses to be 
transmitted. 


e If the host computer responds slowly and the first 
prompt is received (after the output generating 
commands are processed and the command 
response blocks are generated), the block 
acknowledge is still transmitted as the first 
message (because a control block must be 
followed by an output terminator). The next 
prompt then causes the two response blocks to 
be transmitted. 
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Output Rate Control 


Normally, the transmit baud rate is set to the maximum 
value usable by the communications hardware so 
Plotter responses are quickly sent to the host. How- 
ever, if the transmit baud rate is dictated by hardware 
communication capabilities, and if the host cannot 
accept a complete response message at the dictated 
baud rate (due to software limitations), then the 
Transmit Baud Rate Limit function on the Parameter 
Entry Card can be used to reduce the effective transmit 
baud rate. (Refer to Setting Up The Parameter Entry 
Card For Serial Operation earlier in this section for 
more information on this function.) Other ways to 
control the effective transmit baud rate are through the 
DC1/DC3 Control line of the Parameter Entry Card or 
by using Hardware Output Flagging. These methods 
can be used only when the host accepts a limited 
number of characters without a pause during input. The 
following paragraphs discuss these control methods. 


DC1/DC3 Control. If the host computer can utilize 
DC1/DC3 flagging control, then OUTPUT can be se- 
lected on the DC1/DC3 Control line of the Parameter 
Entry Card to allow host control of the Plotter output 
transmission. 


When the host needs to inhibit the Plotter output, it 
sends an ASCII °3 (stop) character to the Plotter. (This 
character can be merged anywhere into other output 
currently being transmitted to the Plotter with the 
exceptions of a DEVICE ON or DEVICE OFF command.) 
When the 93 character is received by the Plotter, 
transmission of further output characters is inhibited 
after any character currently in process has been 
completed. When the host is again ready to receive, it 
sends an ASCII 91 (start) character to the Plotter to 
continue transmission of any other output characters. 


The output is temporarily enabled to allow the 93 
character to be sent to the host if the following three 
conditions occur: 


@ Input and output DC1/DC3 character flagging is 
enabled simultaneously. 


@ The Plotter needs to send a 93 to inhibit output from 
the host. 


@ The host has inhibited output from the Plotter at the 
same time. 
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Hardware Output Flagging. If the host’s interface 
hardware can control the RS-232-C Clear To Send 
signal line, the host can also temporarily inhibit the 
transmission of output characters from the Plotter by 
unasserting this signal line. Asserting the signal line 
again will continue transmission. This function is 
always enabled, requiring the RS-232-C Clear To Send 
signal line to be asserted before any Plotter output can 
be transmitted. 


The Bypass Function 


Many host computers used with terminals send back 
(echo) the received characters for display on the 
terminal. But if output responses from the Plotter are 
echoed back, the characters are processed as com- 
mands. To avoid this situation, the Bypass function 
directs the Plotter to ignore the echoed characters. 
This function is enabled when the SET BYPASS 
CANCEL CHARACTER command changes the bypass 
cancel character to a non-null character. 


If a response is to be sent to the host computer, 
bypassing begins when transmission is started and 
continues until the bypass cancel character is received 
from the host. For example, if the current output 
termination character is a ©r, and the host adds an “r 
character following each ©r, the bypass cancel 
character is set to ‘sr. Then the entire output message, 
sent from the Plotter to the host, would be echoed by 
the host and ignored by the Plotter. The final character 
echoed would be a ©r and the following ‘s character 
added by the host computer would end bypassing and 
allow further commands to be received by the Plotter. 


NOTE 


Characters echoed while bypass is in effect do 
not reset the Turnaround Delay function. 
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During host communication with multiple Plotters in a 
loop-thru configuration, the following communication 
requirements and restrictions apply: 


@ Only the Plotter closest to the terminal should have 
AUTO MUTE selected on the Parameter Entry Card. 


@ Continuous mode and Hardware Receive Flagging 
modes can be used for rate control and allow all 
Plotters to have the same device address and to 
receive commands in parallel. 


@ DC1/DC3 Flagging mode cannot be used for rate 
control in multiple Plotter configurations. 


@ Block mode can be used if each Plotter has a unique 
address. Each Plotter must have a unique prompt 
string and be individually prompted for the block 
acknowledge response. 
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INTRODUCTION TO SERIAL COMMANDS AND RESPONSES 


This section describes how to form commands that 
control the Plotter and how to interpret responses sent 
by the Plotter. To initiate an action, commands are sent 
to the Plotter from a host, a terminal, or a data storage 
device. This action, for example, may be drawing a line 
or generating a response to be sent back to the host 
computer. 


The Plotter provides four Serial command and re- 
sponse formats to accommodate most connected de- 
vices or host computers. 


The actual form of the commands and responses you 
use is determined by the current Command/Response 
Format selection. Refer to Setting Up The Parameter 
Entry Card earlier in this section for a discussion on 
how to select an appropriate Initial Com- 
mand/Response Format. 


Commands recognized by the Serial interface are of 
two general types: Style | commands and Style I! 
commands. 


@ Style | commands are unique Plotter commands that 
use ASCII decimal data coding. These commands 
are easily generated and more readable. 


@ Style Il commands use binary data coding and are 
efficiently transmitted. Style Il commands, 
however, are more difficult to generate and cannot 
be read easily. Style || commands are used with the 
TEKTRONIX 4010 Series Terminals. 


The following describes Style | and Style Il commands 
separately and then shows how both command styles 
can be combined to control the Plotter. 


NOTE 


As characters received by the Serial interface are 
processed into commands, any Nu, §y, x (if DEL 
IGNORE is selected on the Parameter Entry Card), 
P,,23, or characters of a prompt string (when 
Prompt scanning is enabled) are processed sepa- 
rately. These characters can appear anywhere 
within command definitions with the exceptions 
of the DEVICE ON or DEVICE OFF commands. 
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Style | commands are easy to generate either by the 
host computer or by manually entering them ata 
terminal. The general form of Style | commands is: 


<attention character> < address charac- 
ter> < command code> < arguments> 


Each part of the Style | command is discussed in the 
following paragraphs along with any separators and 
terminators required to correctly punctuate the com- 
mand. Also presented is Plotter response to incomplete 
or unrecognized commands. 


Attention Character 


Each Style | command begins with an attention 
character (41) as selected on the Attention Character 
line of the Parameter Entry Card. The chosen character 
should be unique and not be used for other purposes 
except within delimited print string arguments or as 
part of Style Il Attention Action commands. Use of an 
attention character permits the command to be merged 
into a text or graphics message being sent to the 
Plotter as Style Il commands. 


Address Character 


The address character is an uppercase ASCII charac- 
ter that must agree with the address character chosen 
on the Parameter Entry Card. The address character 
allows commands to be directed to a single Plotter 
even when multiple Plotters are connected to the 
communication line. lf each of the multiple Plotters 
have the same address, then all the Plotters can 
receive the commands in parallel. 
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Command Code 


The command code consists of one or two ASCII 
characters (either uppercase or lowercase) that 
uniquely identifies the command. The command code 
for each command is defined in the command descrip- 
tion sections of the manual. The command code can be 
followed by a Sp character instead of a command 
delimiter. 


Arguments 


Any arguments follow the command code. Specific 
arguments for each command are described in the 
command description sections of the manual. There 
are two types of command arguments: numeric or 
string. Individual arguments are partitioned from each 
other by argument separators and the end of an 
argument set is marked by a command terminator. 
Refer to Argument Separators and Command Termina- 
tors later in this section. 


Numeric Arguments. Numeric arguments can be ex- 
pressed in any of three standard forms: integer, floating 
point, or scientific notation. The following examples 
show each form: 


e -—15 (Integer) 
e@+158 (Floating Point) 
@ 0.158E+ 01 (Scientific Notation) 


The following rules apply when entering numeric 
arguments: 


@ When a numeric argument is positive, the “+” sign 
is optional. 


@ Leading zeros are ignored. 
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® |n the scientific notation form: the mantissa can be 
expressed in either integer or in floating point form. 


e The E can be entered either in uppercase or 
lowercase and the exponent can be expressed in 
1 or 2 digits. 


e A“+” sign is not required if the exponent is 
positive. 


e Aspace can be substituted for a “+” sign in 
either the mantissa or the exponent. No other 
spaces should appear within the argument. 


@ Anumeric argument is terminated by any character 
that is not part of a specified numeric form; for 
example, a character that is not one of the digits O 
through 9, and the characters + — eE anda period. 


These numeric argument forms accomodate the 
number formats specified in ANS! Standard X3.42. The 
units, resolution, and allowable range of numeric 
arguments are unique to each command and are noted 
in the command description sections. A selector argu- 
ment is a special type of numeric argument that 
specifies a prenumbered choice, which is defined for 
some commands. 


String Arguments. A string argument represents a 
sequence of one or more ASCII characters in one of 
two forms: as a delimited string or as an undelimited 
string. Three simple examples of the delimited string 
form are shown below, each representing the ASCII 
character “A”. 

e “A” 

SS ‘A’ 

e /65 
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A delimited string can be formed by preceding and 
following a group of one or more ASCII characters by 
the same delimiter (either ’ or “); alternatively, a 
delimited string can consist of a / character (slant) 
followed by the numeric argument that is equal to the 
ADE (ASCII decimal equivalent) value assigned to a 
given ASCII character. The ADE values for each of the 
ASCII characters are shown in Appendix B. 


The delimited string representation can be used to 
specify any ASCII characters with the following excep- 
tions: 


® The string delimiter character. 


@ Characters that cannot be transmitted by the host 
computer interface. 


@ Characters having communications functions. These 
are Nu, Sy, 91 (if DEL IGNORE is selected), 91, or 9s. 


@ The characters of a prompt string (when prompt 
scanning is enabled). 


The ADE representation can be used for any ASCII 
character. You can mix the delimited string and ADE 
representations to form a single, more complex delimit- 
ed string. Additional examples of delimited strings 
follow: 

Delimited String Characters Represented 


“ABC” ABC 
‘AB’/13/10‘CD’ ABCateCD 
‘HeSpsaid:SpISpcan””’t’ He Sp said:Sp “| Sp can’t” 


An undelimited string is a sequence of ASCII 
characters, conforming to the following restrictions: 


@ The first character cannot be one of the following 
characters: 


e The / (slant) 
e The’ (apostrophe) 
e The “ (quote mark). 
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@ The string cannot include any of the following 
characters: 


e Sp 
e , (comma) 


e D 


1 
e 3 
e Ny 
e Sy 
e % (if DEL IGNORE selected) 
e &R 
e ; (semicolon) 
e Ay 
There are two exceptions to these rules that apply only 
to Command/Response Formats 3 and 4: 
@ An undelimited string can include a semicolon 


@ The undelimited string is limited to a single charac- 
ter. (The string is automatically terminated after one 
character.) 


NOTE 


The TEKTRONIX 4662 Plotter does not accept 
delimited strings. Thus, when generating com- 
mands intended for either the 4662 or 4663 
Plotter, undelimited strings must be used. When 
generating commands for the 4663 Plotter only, 
the more general delimited string form can be 
used. 
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Argument Separators 


Argument separators are special sequences of charac- 
ters that define the end of one argument and the 
beginning of the next. A space or a comma character 
are the most common argument separators. However, 
an argument separator can also be expressed in one of 
two more general forms: 


@ A sequence of one or more spaces, or 


@ A sequence of any number of spaces (or none) 
followed by a comma, followed by another sequence 
of any number of spaces (or none). 


NOTE 


The argument separator implies that another 

argument follows (if it is allowed). Therefore, be 
sure that the last argument of a command is not 
foilowed by a space or comma character (which 
would be interpreted as an argument separator). 


Command Terminators 


A command terminator is a character that marks the 
end of the command’s last argument and indicates that 
no more arguments follow. A command is not executed 
by the Plotter until the command has been terminated. 
There are two general types of command terminators 
defined: discarded terminators, and reprocessed termi- 
nators. 


Discarded command terminators explicitly delimit the 
command and, after they are recognized, are discarded 
without further interpretation. The discarded command 
terminators are the semicolon character and the Cr 
character. 
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Reprocessed command terminators are characters 
which terminate a previous command but are also used 
as part of the next command. An example is when the 
attention character for the next command terminates 
the previous command. Take care to properly terminate 
the last argument of a command. 


NOTE 


The characters Nu, Sy, °v (if DEL IGNORE is 
selected on the Parameter Entry Card), °1,°3, the 
characters in a prompt string, or the bypass 
cancel characters (when bypass is active) will not 
act as commana terminators. 


For Command/Response Formats 3 and 4, a semicolon 
character or a °r character are treated as reprocessed 
command terminators (possibly as part of a Style |! 
command). Formats 3 or 4 have no discarded command 
terminators defined. There are several nonprinting 
characters, such as $x, which do not affect Plotter 
output and can be used as reprocessed command 
terminators (if they can be transmitted by the host 
computer). Refer to Table I-1 in Appendix | for an 
overview of characters that do not affect Plotter output. 
A CLOCK END command can be terminated by any 
printing or nonprinting character (as long as the 
character terminates a numeric argument). 


A command is not executed by the Plotter until it has 
been terminated (see following NOTE). Thus, the final 
command in a group of commands should be explicitly 
followed by a terminator. 


NOTE 


For Command/Response Formats 3 and 4, com- 
mands which have no arguments require no 
command terminators. For Formats 1 and 2,a 
command terminator is optional for commands 
without arguments. 
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Multiple Argument Groups 


A complete set of arguments for a command is referred 
to as an argument group. For some commands, multiple 
groups of arguments can follow the command code 
when multiple occurrences of the command are 
desired. An example is a DRAW command that may be 
followed by multiple pairs of X,Y coordinates. The final 
argument group is followed by a command terminator. 
The specific commands that allow multiple argument 
groups to be specified are called out in the individual 
command description sections. 


NOTE 


Commands allowing multiple argument groups 
should be carefully terminated. For example, if 
yOu uSsé a space or comma Character following 
the command, the Plotter assumes more argu- 
ments follow, which causes undesired resuits. 


Null Arguments 


You can specify a null argument in place of an 
expected numeric or string argument. A null numeric 
argument is given a zero value and a null string 
argument is given a value of a single ASCII character 
Ny. Null argument values are established by simply not 
specifying the argument and including only the argu- 
ment separator (or terminator). 


NOTE 


The argument separators must be unique; for 
example, two consecutive commas will specify a 
null argument, but two consecutive spaces will 
not. A space following a command code is 
interpreted as a command code delimiter and not 
as an argument separator defining a null argu- 
ment. Thus, the argument separator must be a 
comma if a leading null argument is to be 
specified. 


Optional Arguments 


Some Plotter commands have optional arguments. 
These optional arguments can be eliminated by 
entering a command terminator before the optional 
argument position instead of a command separator. 
The effects of optional argument selection for such 
commands are discussed in the individual command 
description sections. 
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Command Interpretation 


The following outlines the Plotter’s responses to invalid 
Style | commands. 


@ If the attention character is garbled or omitted, the 
beginning of a Style | command is not recognized 
and the remaining command characters are pro- 
cessed as Style II command characters. 


@ |f the address character is valid (uppercase A 
through H), but is not the current Plotter address 
character, the command is ignored. Commands are 
ignored by discarding command elements (such as 
the command code and arguments) until the com- 
mand is terminated. 


@ |f the address character is not valid, the 4t character 
sequence is checked for a Style II Attention Action 
command. If a sequence is not recognized, the 
characters are discarded and the remaining charac- 
ters are processed as Style Il command characters. 


@ \|f the address character is the current Plotter 
address, but the command code is not recognized, 
an unrecognized command error is generated. Again, 
arguments are discarded until the command is 
terminated. 


@ Errors in argument specifications (which cause a 
delimited string argument to be recognized when a 
numeric argument was expected) cause an argu- 
ment type error to be generated and the command to 
be discarded. 


@ A numeric argument is interpreted as an undelimited 
string argument if a string argument was expected. 


®@ An undelimited string argument (with the exception 
of numbers) is interpreted as a command terminator 
if anumeric argument was expected. 


@ If a command is entered in error, a new command 
can be started anywhere if started with a new 
attention character. The erroneous portion entered 
is discarded or executed, depending upon the 
characters already entered and the errors previously 
described. 
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STYLE Il COMMANDS (4010 SERIES 
TERMINAL COMMANDS) 


The Style Il commands recognized by the Plotter are 
very similar to the commands that control TEKTRONIX 
4010 Series Terminals. For most standard functions, 
the Plotter responds the same as a TEKTRONIX 4014 
Terminal equipped with Option 34 (Extended Graphics 
Module). Refer to Appendix | for more information. 


Style |! commands permit plots developed at a 4010- 
Series Terminal to be sent to the Plotter for a high 
quality plot. Style I! commands are highly coded for 
transmission efficiency and are more difficult to gener- 
ate manually than Style | commands. However, these 
commands are normally generated by host computer 
support software. 


The four basic Style || commands are shown in Figure 
4-11.Each command controls some basic Plotter 
action, such as printing characters, moving the pen, 
drawing lines, arcs, and circles with the pen, and 


COMMANDS 


GENERAL FORM 


Point Plot 


Attention | ATTENTION 





marking points at specific coordinates. The Attention 
Action commands control special functions or estab- 
lish parameters for print or plot actions. Each of these 
commands (with their functions and parameters) are 
discussed in the following text. 


These commands are expressed to the Plotter by first 
sending a mode control character (such as, Ys, Ss, Fs, or 
At) to place the Plotter interface into the proper mode. 
The relationship between these modes is defined by 
the mode transition diagram shown in Figure 4-12. 


The mode control characters are similar to command 
codes. The modes “remember” that the corresponding 
commands are being processed. Thus, the mode 
control characters do not need repeating for each 
successive command unless the mode is changed. 
While the Plotter interface is in the desired mode, 
successive characters received are interpreted as 
arguments for the corresponding commands. The re- 
quired coding for these arguments is described for 
each of the modes. 


3806-17 


Figure 4-11. Basic Style Il Commands. 
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GRAPH 
ATTENTION 
MODE 


ALPHA 


ATTENTION 
MODE 


é 





Figure 4-12. Style Il Command Modes. 


© 
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Alpha Mode 


To print characters using Style Il commands, send a Ys 
character to the Plotter to force Alpha mode. The 
Plotter automatically resets to Alpha mode at power-up 
or when a front panel Initialize function is performed. In 
Alpha mode, subsequent characters sent to the Plotter 
are normally printed beginning at the current pen 
position. Refer to the Alpha Commands section of this 
manual for a detailed description of the print actions 
for each ASCII character. (The characters Fr, So, and § 
and the mode control characters cannot be printed in 
Alpha mode.) Also, several Attention Action commands 
affect Alpha mode printing actions. Refer to Attention 
Action Mode later in this section for more information. 


NOTE 


A solid line type is always used when alpha 
characters are drawn regardless of the current 
graphic line type. 


Graph Mode 


To draw lines using Style Il commands, send a Ss 
character to the Plotter to force Graph mode. In Graph 
mode, the Plotter can perform Moves, Draws, Arcs, and 
Circles. Move and Draw actions and the methods that 
specify their arguments (consisting of encoded pairs of 
X and Y coordinates) are described next. Arcs and 
Circles are described later in this section. 


INTEGER BITS 


The first X,Y coordinate pair received following the Ss 
character is interpreted as a MOVE command 
coordinate, which causes a pen up motion to the 
specified position. Successive X,Y coordinate pairs are 
interpreted as DRAW command coordinates, which 
cause a Straight line to be drawn from the current 
position to the specified positions. When a Draw, Arc, 
or Circle is specified, it is drawn using the current 
graphic line type (Solid, dashed, dotted, etc.). This line 
type can be set with either an Attention Action 
command or a SET LINE TYPE command. 


A Move can follow a Draw by preceeding the MOVE 
command's coordinate with another Ss character. The 
Move following the &s can be suppressed by either: (1) 
following the &s with the current coordinates (which 
generates a Move to the current position), or (2) 
following the °s character with a 8. (bell) character 
(which changes the following Move to a Draw and rings 
the bell). 


Coordinate Encoding. The X,Y coordinate pairs sent 
to the Plotter as MOVE or DRAW command coordinates 
are described as two 16-bit binary coordinates in 
Figure 4-13. Thus, each coordinate has 12 bits of 
integer value and 4 bits of fractional value. This gives a 


0 to 4096.9375 coordinate range where the units are in “=” 


ADU’s. 


FRACTIONAL BITS 


eT 


X-COORDINATE bis big bi3 bi2 b44 bio Do bg b7 be bs ba e bg bo by Do 


IMPLIED BINARY POINT 


Y-COORDINATE bis biq 643 by2 b44 bi9 Dg bg bz bg bs bg @ bg bo by bo 


Figure 4-13. 16-Bit Binary Coordinates. 
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NOTE 


The X,Y coordinates specified in Style Il com- 
mands are always interpreted as World Units with 
ADUs as the current Device Units regardless of 
the graphic units selected in either the SELECT 
GRAPHIC UNITS or SELECT DEVICE UNITS com- 
mand. When using Style |! commands, the current 
graphic units should be World Units, and the 
current Device Units should be ADU’s. 


Figure 4-14 defines five groups of binary bits within 
each 16-bit binary description (for example, HIX, LOX, 
EB, EEB, and EEEB for the X-coordinate). The bit 
patterns that appear in these groups are mapped into 
portions of the ASCII character set as shown in Figure 
4-15. The five least significant bits of the 7-bit ASCII 
characters are matched with the corresponding bit 
patterns. 


The other two bits of the 7-bit ASCII characters identify 
one of the seven coding groups. The appropriate ASCII 
characters are then used to express the encoded 
coordinates. The HIX and HIY groups are assigned to 
the same portion of the ASCII character set and 
identified by the order in which the Plotter receives 
them. The same holds true for the extra bytes (EB, EEB, 


he yy and EEEB) that are assigned to the same portion of the 


LOY byte. 


X-COORDINATE | by5by4b,3by9 by4 


Y-COORDINATE | 61561461342 by, 
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NOTE 


The correct identification of the encoded coordi- 
nate characters depends upon the order in which 
the characters are received. If a sequence of 
coordinate characters is interrupted while being 
received (before the LOX character is received), a 
following sequence must begin with another &s 
character to mark the beginning of a sequence. 


NOTE 


This coding scheme requires that the host com- 
puter be able to transmit all of the characters in 
the last six columns of Figure 4-15, plus the 
current attention character. 


Some host computers use the 9. character for system 
functions. In this case, an 47 ? Attention Action 
command can be substituted for the °L character 
during encoding of the X,Y coordinate pair. Refer to 
Attention Mode further in this section for more informa- 
tion. 


A detailed definition of the bytes required to encode 
the X,Y coordinate pair, including the order in which 
they are transmitted to the Plotter, is defined in Table 
4-3. 


3806-20 


Figure 4-14. Definition of Graphic Coding Groups. 
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B7 8 g g B 1 1 1 1 
B6 g g f 1 g g 1 1 
B5 g 1 | 1 g ‘4 g 1 
ae Poe 4s LOX oY 
nee HIY EB EEB EEEB 
° NU ®s 120 140 ‘< 160 
6008 ae LAE “@ P 
o NUL of}10 pL 16] 20 64] 50 80/60 96| 70 P 112 
SH 121 141 161 
a8 1 "A Q a 
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17 UNL9117 157 DT 
fori Sy af = Wir, 
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*| 
1on some keyboards or systems 


KEY 


octal | 25 


“3 
hs 


a 
= 





0 





NK graphic representation 


NAK 
hex | 15 21 decimal (2670) 3806-21 


mnemonic 
Figure 4-15. ASCII Code Chart Showing Assignment of Graphic Coding Groups. 
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Table 4-3 


PACKED BINARY COORDINATE CODING DEFINITION 
























































7-Bit ASCII Character 
Byte Byte Fixed ‘| Data 
Number Name Bits Bits 
B, | B, | B B, |B, |B, |B, 
——- = ES == =. —4 
1 High Order Y (HIY) 0 1 YI5 Y14| Y13 | Y12 | Y11 
5 most significant bits of Y 
2 Extra3 Byte (EEEB) |1 | 1 | * v1 | Yo [x1 [xo 
Unused | 2 lowest 2 lowest 
bits of Y bits of X 
3 Extra 2 Byte (EEB) 1 * v3 | y2 |x3 [x2 
Unused | 2 lower 2 lower 
bits of Y bits of X 
4 Extra 1 Byte (EB) 1 ale * ys | y4 1x5 [x4 
Unused | 2 low 2 low 
iS 4 bits of Y bits of X 
5 Low Order Y (LOY) 1 1 Y10 ¥9: | Y8 | ¥7 Y6 
5 intermediate bits of Y 
6 High OrderX (HIX) [O | 14. | X15 [X14] x13] X12 [x11 
5 most significant bits of X 
7 Low Order X (LOX) |1 | 0 |x10 |x9 | x8 |x7 |x6 





zai 


























5 intermediate bits of X 





* Designates a “don’t care” bit position. 


This coding results in the following graphic character 
sequence, which specifies a 16-bit XY coordinate pair: 


Plotter ~— HIY EEEB EEB EB LOY HIX LOX~«—HOST 
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These characters must appear in the defined order to 
be correctly interpreted. Appendix F contains two types 


of tables that you can use to determine the coded bytes 


required to 


define a given X,Y coordinate pair. 
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Coordinate Resolution. When the Plotter operates at 
less than maximum resolution, all 16 bits do not need 
to be transmitted to the Plotter, which results in greater 
transmission efficiency. Different resolutions of 10, 12, 
14, and 16 bits can be tranmitted for the X,Y 
coordinates by simply eliminating the appropriate num- 
ber of extra bytes. These optional bytes permit coordi- 
nate resolutions as shown in Table 4-4. 


Table 4-4 
COORDINATE RESOLUTION 





























Coordinate | Resolution Extra Bytes 
Bits (ADUs) Required 

10 4 

12 i 

14 25 EEB, EB 

16 0625 EEEB, EEB, EB 





Optimized Coordinate Encoding. Further transmis- 
sion efficiency can be achieved by optimizing 
coordinate transmission. When the Plotter receives 
coordinate specifications, the graphic bytes update two 
16-bit graphic memory coordinates (which always 
reflect the current graphic position). The current values 
of the graphic memory coordinates are then used to 
form the internal arguments for the MOVE or DRAW 
commands (and the ARC, CIRCLE and POINT com- 
mands described in following sections). Thus, it is 
necessary to transmit only the portion of these coordi- 
nates that changes from the last Move or Draw. Table 
4-5 defines the minimum number of bytes that must be 
used to transmit the coordinate bits. 
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Table 4-5 


INSTRUCTIONS FOR OPTIMIZED 
BINARY COORDINATE CODING 




































































Bytes Sent 
Bytes 
Changed HIY | EEEBIEEB|EB | LOY|HIX | LOX 
————— SS == == 
HIY X | X 
EEEB ‘a x Ix Ix |x X 
EEB x xe lex X 
EB tye X E X 
LOY X X 
HIX xe ix 1x 
LOX if Xx 
NOTE 


If the specification of an X,Y coordinate is 
interrupted and then restarted, the graphic memo- 
ry is modified even if no LOX character is 
received to initiate the corresponding Move or 
Draw action. Therefore, to ensure that the graphic 
memory contains the desired values, the restarted 
graphic sequence should be fully specified and 
not optimized. 


NOTE 


The graphic memory in the Plotter is only reset to 
0 during power-up or when a front panel Initialize 
function is performed. Therefore, a plot should 
normally begin with a full 16-bit coordinate 
specification that sets all coordinate bits to 
known values even if less resolution is used for 
the remainder of the plot. 
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Arcs and Circles. You can plot arcs and circles while 
in Graph mode using binary coded arguments (requires 
Option 31). To plot a circle using Style II commands, an 
So character is sent to the Plotter immediately followed 
by a coded X,Y coordinate pair. The X value specifies 
the radius of the circle to be drawn around the current 
pen position. The Y value is unused and the pen is left 
at the circle center. 


NOTE 


The specification of the circle radius modifies the 
graphic memory coordinates in the Plotter. Thus, 
the next graphic coordinate specification should 
be sent to the Plotter as a complete specification 
and should not be optimized. 


Enter Graph mode to pilot an arc using Style II 
commands. Then an §1 character is sent to the Plotter 
immediately followed by a coded X,Y coordinate 
defining the midpoint of the arc, which in turn is 
followed by another coded X,Y coordinate defining the 
end point of the arc. This causes an arc to be plotted 
from the current position through the specified mid- 
point to the end point. 


Both DRAW CIRCLE and DRAW ARC commands re- 
quire that the Plotter be equipped with 4663 Option 31 
(Arcs, Circles, and Programmable Macros). Refer to the 
Graphic Commands section for more details concern- 
ing these functions. 


If Option 3l is not present, the DRAW CIRCLE command 
is ignored and the DRAW ARC command causes Draws 
to the midpoint and then to the endpoint of the 
specified arc. 
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Point Plot Mode 


To locate a dot at specified coordinates without 
performing Move or Draw operations, send an Fs 
character to the Plotter to force Point Plot mode. In this 
mode, the current graphic line type is saved. Then the 
graphic line type is changed to point, which causes a 
dot to be piaced at each specified coordinate. This 
action is not affected by Move or Draw interpretations 
of coordinates. 


Point Plot mode is exited by sending a Ys character or a 
At Fe attention sequence to the Plotter, forcing the mode 
to Alpha. When Graph mode is entered following Point 
Plot actions, the graphic line type (solid, dashed, etc.) 
that was previously in effect for Graph mode is 
restored. If an Attention Action command that changes 
the graphic line type is received while in Point Plot 
mode, the new specified line type does not take effect 
until Graph mode is entered again. 


NOTE 


Only graphic line types specified by Attention 
Action commands (and not via the SET LINE 
TYPE command) are restored when Graph mode 
is re-entered following Point Plot actions. Also, if 
Point Plot mode is exited via an 47 ¥r Attention 
Action command, the graphic line type is forced 
to solid. For more information, refer to Attention 
Action Mode described next. 
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Attention Action Mode 


The Attention Action commands allow special functions 
to be performed or parameters to be established 
without changing the basic command mode. 


NOTE 


Referring back to the Figure 4-12 mode diagram, 
there are three Attention Action modes: Alpha 
Attention, Graph Attention, and Point Attention. 
Unless the Attention Action command causes a 
mode change, the current mode (Alpha, Graph, or 
Point) will be reestablished after the Attention 
Action command process is completed. 


Unless noted otherwise in the following discussion, the 
Attention Action commands perform the same function 
in all three modes (Alpha, Graph, or Point). The 
Attention Action command can appear at any point 
within the character sequences that are used to form 
commands for the specific mode. Also, unless noted, 
the Attention Action commands are always two charac- 
ters long: the current 41 character (specified in the 
Paramenter Entry Card) and a specified action charac- 
ter. 


Tables 4-6 through 4-8 list the Attention Action 
commands and describe the resultant Plotter action. 
The use of any ASCII characters not listed in these 
tables are ignored. 


NOTE 


Each Attention Action command must be com- 
pleted before another is specified. Two 
successive “7 characters are equal to one 4r 
character. Any following characters are ignored if 
they appear between an “7 character and the 
second character of an Attention Action com- 
mand (+r, ©r, or Nu). 
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Table 4-6 


ATTENTION ACTION COMMANDS 
AND THEIR EFFECTS 























Attention 

Action 

Command |Action 

—=—— 

AT? is converted to a". character and interpreted as 
a LOY graphic byte. 

AyS.. [Bell sounds. Can be used to ring bell without 
affecting the mode. 

Aras Equivalent to Ss 

ATUs Equivalent to Ys 

ATF Forces the Plotter to Alpha mode, forces the 


graphics line type to solid, and performs the 
Move-To-Home function. Can be used to 
establish a known state for these parameters. 
Equivalent to a Style/I Print "= command?. 





ATSo Activates the Alternate Alpha character set. 
Equivalent to a Style | Print $0 command?. 





ATS Activates the Standard Alpha character set. 
Equivalent to a Style | Print §| command?. 








®Reter to the Alpha Commands section for more details about these actions. 


Table 4-7 specifies the Attention Action commands 
that establish alpha character size values equivalent to 
the TEKTRONIX 4014 Series large, #2, #3, and small 
character sizes. Refer to the Alpha Commands section 
for more information on alpha parameters. 
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= Table 4-7 
SPECIFIERS FOR ALPHA CHARACTER SIZE 
Attention Corresponding Corresponding 
- Action Character Character Character Line 
Command Width(ADUs)? Height (ADUs)® Space(ADUs) Space(ADUs) 
= —————— —— 
AT 8 37.33 53.78 56 88 
a AT9 34.00 50.11 51 82 
AT: 22.67 32.39 34 53 
AT: 20.67 29.33 31 48 
= 2Asauming the default Alpha X-Ratlo and Y-Ratio values of 3/2 (1.5) and 18/11 (1.64) respectively. 
a Table 4-8 specifies the Attention Action commands Table 4-8 
that establish line types, dash patterns, and dash SPECIFIERS FOR LINE TYPES 
pattern lengths that are equivalent to the TEKTRONIX AND DASH PATTERNS 
4010 Extended Graphics Module (EGM) line types and 
- dash patterns. Also refer to Section 11 for more Attention 
information about line types and dash patterns. Action Line Dash Dash Pattern 
Command | Type Pattern? Length (ADUs) 
= Ay? Solid N/A N/A 
For the Plotter, 4014 Extended Graphics Module Ath Solid N/A N/A 
(EGM) defocused and write-through vector line ATDp Solid N/A N/A 
~ types are drawn the same as the corresponding Are Solid N/A N/A 
= normal line types. Arm Solid N/A N/A 
AT u Solid N/A N/A 
Arf Solid N/A N/A 
= Atn Solid N/A N/A 
AtTy Solid N/A N/A 
AT g Solid N/A N/A 
= ATO Solid N/A N/A 
ATW Solid N/A N/A 
AT a dotted 1,1 (dot,space) 11 
At j dotted 1,1 (dot,space) 11 
at ATq dotted 1,1 (dot,space) 14 
AtTb dot-dash | 5,1,1,1 (dash,space, | 88 
dot,space) 
At j dot-dash | 5,1,1,1 (dash,space, | 88 
- dot,space) 
Arr dot-dash | 5,1,1,1 (dash,space, | 88 
dot,space) 
- Ato short dash | 3,1 (dash,space) 44 
ATk short dash | 3,1 (dash,space) 44 
ATS short dash | 3,1 (dash,space) 44 
Atd long dash | 6,2 (dash,space) 176 
= AT long dash | 6,2 (dash,space) 176 
Art long dash | 6,2 (dash,space) 176 
®The number Indicates the number of dashes, spaces, or dots the Plotter draws. 
- For example, Atb plots 5 dashes, 1 space, 1 dot, and 1 space 
(----- e ----— oe ). 
~~ 
ae 
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MIXING STYLE! AND STYLE Il 
COMMANDS 


All Plotter functions can be controlled by Style | 
commands when the interface is in any Style II 
command mode (Alpha, Graph, Point, and Attention 
Action). In addition, many Plotter functions have a Style 
{| equivalent command (where the capabilities of the 
Plotter overlap the capabilities of TEKTRONIX 4010 
Series terminals). Either command style can be used 
when equivalent commands are available. Style | 
commands can be viewed as a large set of multichar- 
acter Attention Action commands. Thus, Style | com- 
mands can appear within Style Il commands anyplace 
an Attention Action command is appropriate. 


When only Style | commands are used, the Serial 
interface is always in Alpha mode (because the Plotter 
powers up in that mode). For this reason, be sure you 
correctly terminate Style | commands; any stray char- 
acters following these commands are interpreted as 
PRINT command arguments and are printed. 


OUTPUT RESPONSES 


Output messages (consisting of DC1/DC3 control 
characters), control blocks, and response blocks are 
transmitted from the Plotter to the host in response to 
output-generating Plotter commands. The Plotter 
encodes these messages according to the Initial 
Command/Response Format in effect. The following 
paragraphs explain how the host decodes each type of 
response to retrieve the desired information. The 
DC1/DC3 control character responses require no de- 
coding. Refer to Plotter-To-Device Transmission earlier 
in this section for more information on how these 
blocks are actually transmitted to the host. 
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Control Block 


Use control blocks for Plotter functions where no data 
values are required. The only control block responses 
transmitted by the Plotter are the negative and positive 
Block Acknowledge characters (I and A) used in Block 
mode communications (see Host-To-Plotter Transmis- 
sion earlier in this section). These blocks are always 
one Character in length and are encoded as shown in 
Figure 4-16, regardless of the selection of the Initial 
Command/Response Format line of the Parameter 
Entry Card. 


WHERE:P=PARITY BIT 
COAND C1=CONTROL BITS 
3806-22 


Figure 4-16. Control Block Coding. 


The control bits (CO and C1) are encoded as either “O 
0” (a positive Block Acknowledge giving the ASCII 
character ‘“‘A”) or as “O 1” (a negative Block Acknowl- 
edge giving the ASCII character ‘‘I"). The “O 0 1” value 
for Bits 3 through 1 is the control block TAG value. The 
“4 0” value for Bits 7 and 6 indicate that this is the last 
byte of a binary coded block. 
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Response Block 


A response block is used by the Plotter when 
responding to all other output-generating commands. 
The response block, which can range from 7 to 33 
characters in length (depending upon the data values 
and the current Command/Response Format selection), 
consists of two data values along with a TAG value. 
The two data values are typically obtained from the 
encoding of several pieces of requested information. 
The information can then be decoded from the data 
values by reversing the encoding process. Refer to the 
specific output-generating command for more informa- 
tion. 


For Formats 1 and 2 (the standard Plotter formats), the 
interpretation of TAG values is explained for each 
output-generating command in the command descrip- 
tion sections. Since the TAG values have no fixed 
meaning, these formats are called unlabeled. Correct 
interpretation of the Plotter output responses requires 
the host to keep track of the order in which requests 
were made and to match up returned data with the 
requests. The Plotter returns data in the same order 
you request it. 


For Formats 3 and 4 (4662 compatability formats), the 
TAG bits have preassigned values (which allow the 
host to match up responses with requests by looking at 
the TAG values that act as labels). However, even in 
Formats 3 or 4, the responses are returned in the same 
order they were requested. 


Following is a description of the data blocks for each 
Command/Response Format. This description can be 
used along with the description of the output data 
encoded for a particular command (see Section 7) to 
determine the actual response bytes transmitted. 
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Format 1 — Unlabeled Binary Output. The packed- 
binary format consists of seven consecutive ASCII 
characters. These are encoded as shown in Figure 
4-17 from two 16-bit numbers and three bits of TAG 
information. The coding (defined more formally in 
Figure 4-18) uses only the ASCII characters “Space” 
to “Underline” (ADE 32 to ADE 95) to permit return of 
responses to the host even if the host computer’s input 
character set is restricted (such as when lowercase 
characters are not accepted). 


For all responses except coordinate values, the 16-bit 
values are integers with a numeric range of 0 - 65535. 
For coordinate values, a binary point is assumed 
between Bits 3 and 4 giving a numerical coordinate 
range of 0 — 4095.9375. Digitized coordinates greater 
than 4095.9375 cannot be encoded in this format and 
thus, initiates an output value range error. The coordi- 
nate range to be digitized should either be restricted or 
Format 2 must be used. For Command/Response 
Formats 1 and 2, the digitized coordinate resolution is 
16 bits. For Command/Response Formats 3 and 4, the 
digitized coordinate resolution is 12 bits, giving a 
numerical coordinate range of 0 — 4095. 


NOTE 


If the coordinate value to be transmitted has a 
value of 4096, it will be sent as 4095.9375 (for 
16-bit resolution) or as 4095 (for 12-bit 
resolution) with no error indicated. 
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Figure 4-17. Packed Binary Response Block Format. 
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3 HIGH X ce) 1 X10 Xp Xs X, Xe 
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5 INTERMEDIATE BITS OF DATA VALUE 2 
— 
MID X ) 1 Xs X, X, X, X, 
NEXT 5 INTERMEDIATE BITS OF DATA VALUE 1 
-_ 6 MID Y ) 1 Ys Y, Y, Y, Y, 
NEXT 5 INTERMEDIATE BITS OF DATA VALUE 2 


7 LOX, LOY, TAG Xo Yo T T Ty 


2 1 
i.’ 2 TAG VALUE 














—- LSB OF LSB OF 
DATA VALUE DATA VALUE 
1 2 3806-24 


= Figure 4-18. Packed Binary Response Format. 
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For Format 1, TAG bits may have the numeric values 
shown in Table 4-9, depending upon the response 
being transmitted. 


Table 4-9 
TAG VALUES FOR FORMAT 1 











— 
TAG Value | TAG Value 
(Decimal) |(Binary) |Meaning 
= —— 
0 000 Not used 
1 001 Contro! Block (see Control Block 
description) 
2 010 Not Last Block 
3 011 Not Last Block 
4 100 Last Block 
5 101 Last Block 
6 110 Not Used 
7 APA Not Used 











The last block designation allows command responses 
that consist of a variable number of blocks to be 
terminated. 


Format 2 — Unlabeled ASCII Output. This ASCII 
format consists of two data values and the TAG value, 
all expressed as ASCII decimal numbers separated by 
commas, as shown below: 


Number 
TAG Value 


Number, Number, 


Value 1 Value 2 


The format of the numbers depends upon the current 
output graphic units. If World Units are being used, the 
numbers (including the TAG value) are expressed in 
the following scientific notation form: 


— X.XXXXXE+ XX 
or 


Sp X.XXXXXE+ XX 
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The sign of the mantissa is a space character if the 
number is positive and a minus sign if the number is 
negative. The mantissa accuracy can be up to five 
digits to the right of the decimal point. The exponent 
always contains two digits and is always preceeded by 
either a “+” ora “—” sign. 


\f current output graphic units are Device Units (ADUs, 
GDuws, or millimeters), the output numbers (including 
the TAG value) will be in fixed point format with a fixed 
width shown below: 


— XXXXX.XXX 
or 
Sp XXXXX.XXX 


The sign is a Sp character if the number is positive and 
a “—” if the number is negative. Leading zeros and/or 
trailing spaces are generated to maintain both the field 
width (ten characters) and the location of the decimal 
point in the field. 


For Format 2, the TAG number may have the values 
shown in Table 4-10, depending upon the response 
being transmitted. 


Table 4-10 
TAG VALUES FOR FORMAT 2 











TAG Value 

(Decimal!) Meaning 

(0) i; Not Last Block 

1 Not Last Block 
Last Block 

3 Last Block 








The last block designation allows command responses 
that consist of a variable number of blocks to be 
terminated. 
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Format 3 — Labeled Binary Output. This packed- 
binary output format is the same as Format 1, with the 
exception of TAG value interpretations, which are 
shown in Table 4-11. 











Table 4-11 

TAG VALUES FOR FORMAT 3 
TAG Value | TAG Value 
(Decimal) (Binary) Meaning 

= Tr 
0 000 Digitized Block — Pen Up 
1 001 Control Block 
2 010 Status Block 
3 011 Size Block 
4 100 Digitized Block — Pen Down 
5 101 Not used 
6 110 Not Used 
7 111 Not Used 
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For this format, the type of response data (Digitized, 
Status, etc.) can be determined by referring to the TAG 
values. The indicated response types are the only ones 
that can be requested in this format (all defined 
responses can be transmitted when using Formats 1 or 
2). For digitized responses (using Formats 3 and 4), the 
coordinate value Bits 3 through O of both data values 
are set to O. This results in 12-bit resolution for 
digitized graphics. 


Format 4 — Restricted Labeled Binary Output. This 
format is the same as Format 3 with one exception: Bit 
O of the X-coordinate value (for digitize responses) is 
always set to 1 to avoid encoding an “@” character in 
the output. Some host computers use the “ @” charac- 
ter for special functions. 
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Section 5 


GPIB INTERFACE 


INTRODUCTION 


This section describes five aspects of the GPIB 
interface: 


@ Connecting the Plotter to other GPIB devices. 


@ Making selections on the Parameter Entry Card that 
allow other GPIB devices to communicate with the 
Plotter. 


@ Controlling transmission of information to and from 


the Plotter. 


@ Understanding the various ways in which Plotter 


commands are formated. 


® Decoding Plotter responses. 


CONNECTING THE PLOTTER TO OTHER DEVICES 


The General Purpose Interface Bus (GPIB) is a stand- 
ardized interfacing system defined by IEEE Standard 
488-1978 for programmable measuring apparatus. 
This standard defines the mechanical, electrical, and 
) procedural (such as, how to send data bytes to and 
from the interface) characteristics of the bus. Stan- 
dardization allows the Plotter to be easily installed in 
various systems with devices that communicate 
through the GPIB. However, GPIB information (consist- 
ing of commands and responses that are transfered 
over the GPIB bus) is not defined in the standard, and 
is unique to the Plotter. This subject is discussed 
further under Introduction to GPIB Commands and 
Responses in this section. 


NOTE 


The Plotter is designed to work with other devices 
that conform to IEEE Standard 488-1978. How- 
ever, the Plotter’s GPIB interface does exhibit 
some minor limitations in comparison to the 
standard GPIB. These limitations are discussed in 
Appendix E. 
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The GPIB allows devices to be interconnected in any 
convenient configuration if the following limitations are 
observed: 


@ The total length of GPIB cable in the system must be 
either less than 66 feet (20 m) or 6.5 feet (2 m) times 
the number of devices connected to the system, 
whichever is less. 


@ No more than 15 devices can be connected to the 
system. For operation with maximum reliability, 
individual cable lengths should be less than 13 feet 
(4 m) and at least two-thirds of the devices connect- 
ed to the system should be powered up when the 
system is operating. 


Refer to IEEE Standard 488-1978 for additional 
guidelines covering GPIB operation at maximum data 
transfer rates. 


Figure 5-1 illustrates a typical system interconnection 
configuration showing the flexibility of GPIB. More than 
one Plotter can be connected in the system. 


In addition, the Plotter can be connected to other GPIB 
devices with or without a GPIB controller present. 
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Figure 5-1. Typical GPIB System Interconnections. 
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SETTING UP THE PARAMETER ENTRY CARD 


Selections made on the GPIB interface Parameter Entry 
Card lines permit the Plotter to operate in a variety of 
communications environments. The following describes 
the choices and helps determine selections that are 
applicable to particular communication environments. 


The Parameter Entry Card lines described here are the 
Interface Select line, the Initial Command/Response 
Format line, the GPIB Device Address line, the Interface 
Mode line, and the Interface Functions line (see Figure 
5-2). Refer to the description of the Parameter Entry 
Card in the 4663 Operator's Manual! for help in making 
any of the selections described in this section. 


INTERFACE SELECT LINE 


Selections made on the Interface Select line deter- 
mines which hardware interface is active. For a Plotter 
shipped with an Option 01 Interface (Serial and GPIB), 
selecting ‘‘1” on the Interface Select line activates the 
installed Serial interface (RS-232-C or Current Loop). 
Selecting “2” on this line activates the GPIB interface. 
If Option 04 (GPIB only) is installed, the 1” selection 


activates the GPIB interface and the “2” selection is 


inactive. Table 5-1 summarizes the possible selections. 


NOTE 


If the straps on the Interface circuit board have 
been reset, the selection activated by “1” or “2” 
will be different from that shown in Table 5-1. 
Refer to the 4663 Service Manual for additional 

















information. 
Table 5-1 
INTERFACE DESIGNATIONS 
Interface(s) Option Interface Select Line 
Installed Number 1 
= = = 

Serial Only (Standard) Serial Not used 
Serial and GPIB (Option 01) Serial GPIB 
GPIB Only (Option 04) GPIB Not used 
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INITIAL COMMAND/RESPONSE 
FORMAT LINE 


Selections made on the Initial Command/Response 
Format line configures the GPIB interface to accept 
commands and to output responses in a specified 
format. Refer later in this section to Introduction to 
GPIB Commands and Response for a more detailed 
description of the various command and response 
forms used with each format. 


If you are installing the Plotter in an existing system, 
the selection made on the Initial Command/Response 
Format line must agree with the existing system 
formats. If the system is to be reprogrammed, then the 
format choice can be based upon the ease with which 
the formats are generated by the system. The format 
selection must also satisfy the message termination 
requirements of the system devices. The following 
paragraphs describe each of the Initial Com- 
mand/Response Format line selections and indicate 
how an appropriate choice is made. 


NOTE 


The selection on the Initial Command/Response 
Format line configures the interface: (I) at power- 
up, (2) when a new selection is made on the 
Initial/Command Response Format line, (3) when 
the GPIB interface is first selected on the Inter- 
face Select line, and (4) after an INTERFACE 
PARAMETER RESET command. The SELECT 
COMMAND/RESPONSE FORMAT command, 
when received, overrides the Initial Com- 
mand/Response Format selection, but does not 
modify it. This permits the configuration defined 
by the Parameter Entry Card selection to be 
restored when one of the three previous condi- 
tions listed occurs. 


The following describes only the Initial Command/ 
Response Formats as they apply to a GPIB interface. 
The function of each format changes when the Serial 
interface in selected. Refer to Section 4 for more 
information about the Serial Command/Response For- 
mats. 
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Command/Response Format 1 


Format 1 features are: 
@ 4663 Command Set 
@ Output Terminator EOI 


This format permits all 4663 commands to be used. 
The arguments for PRINT and PRINT CENTERED 
CHARACTER commands are special string arguments 
that (1) can contain any character and (2) are 
terminated only by =r or by the EO! bus message sent 
with the last string data byte. For this format, response 
messages transmitted by the Plotter are terminated by 
the EOI bus message sent with the last data byte 
transmitted. This is the most compatible format for use 
with the following GPIB devices and controllers: 


@ TEKTRONIX 4050 Series Graphic Computer 
Systems 


@ TEKTRONIX 4924 Digital Cartridge Tape Recorder 
@ TEKTRONIX 4040 Series Computer/Controller 
Systems 


This format is also used with other devices or controll- 
ers that allow input to be terminated with the EOI bus 
message sent with the last data byte transmitted. 


Command/Response Format 2 


Format 2 features are: 
@ 4663 Command Set 
®@ Output Terminator Cr, ‘e, and EOI 


This format allows all 4663 commands to be used. The 
arguments for PRINT and PRINT CENTERED 
CHARACTER commands are special string arguments 
that can contain any character and are terminated only 
by =r or the EOI bus message sent with the last string 
data byte. For this format, response messages trans- 
mitted by the Plotter are terminated by a ©r followed by 
a ‘r sent with the EO! bus message. 


This is the most compatible format for use with the 
following GPIB devices and controllers: 


@ HP 9800 Series 
@ FLUKE 1720A 
@ PET 2001 


This format is also used with other devices or controll- 
ers that permit input to be terminated by nr, ©r ‘r, “, or 
te and an EOI bus message. 
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Command/Response Format 3 


Format 3 features are: 

@ 4663 Command Set 

® No Print String Arguments 

@ Output Terminator EOI 

This format is identical to Format 1 except that print 
string arguments are not available. This format allows 


the same string forms to be used for all string 
arguments. 


Command/Response Format 4 


Format 4 features are: 

@ 4663 Command Set 

@ No Print String Arguments 

® Output Terminator, °r, ‘re, and EO! 

This format is identical to Format 2 except that print 


string arguments are not available. This allows the 
same String forms to be used for all string arguments. 


Command/Response Format 5 


Format 5 features are: 
® 4662 Compatible Command Set 
@ Output Terminator EO! 


This format permits a 4663 Plotter to be installed in 
systems that previously used a TEKTRONIX 4662 
Plotter. All 4663 commands can be used, allowing the 
system to be upgraded. All 4663 output generating 
commands that do not have 4662 equivalents generate 
their output in the same form as for Format 1. 


This format is the most compatible format for use with 

the following GPIB devices and controllers: 

@ TEKTRONIX 4020 Series Terminals with Option 04 

@ TEKTRONIX 4081 

@ TEKTRONIX 4014/4015 with Option 05 anda 
TEKTRONIX 4907 


This format is also usable with any of the devices and 
controllers listed in Format 1 if the system software 
was written fora TEKTRONIX 4662. 
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Command/Response Format 6 


Format 6 features are: 
@® 4662 Compatible Command Set 
@ Output Terminator, ©r, ‘r, and EO! 


This format allows a 4663 to be installed in a system 
which previously used a TEKTRONIX 4662. All 4663 
commands can be used, allowing the system to be 
upgraded. All 4663 output generating commands that 
do not have 4662 equivalents generate their output in 
the same form as for Format 2. All remaining output 
generating commands create their output in Format 6. 


This is the most compatible format for use with any of 
the devices and controllers listed in Format 2 if the 
system software was written fora TEKTRONIX 4662. 
Refer to Appendix H for more information. 


Command/Response Format 7 


Format 7 features are: 
@ 4663 Serial Interface Commands 
@ No Output 


This format permits commands to be transmitted to the 
Plotter via the GPIB in the form used with a Serial 
interface operating in Serial Command/Response For- 
mat 1. This allows commands generated by or received 
from a non-GPIB system to be transmitted (via GPIB) to 
the Plotter without modification. The attention and 
device address characters used in serial Plotter 
commands are assumed to be the characters Fc and A, 
respectively. 


All output generating commands and Serial interface 
commands are ignored and no output is generated in 
this format. 


This is the most compatible format for use with the 
following GPIB devices and controllers: 


@ TEKTRONIX 4014 Option 05 with a TEKTRONIX 
4907 


This format is also used with other devices or control- 
lers that need to transmit Serial format type commands 
to the Plotter. 


a 
(o>) 


GPIB DEVICE ADDRESS LINE 


Selections made on the GPIB Device Address line 
configure the interface to respond to GPIB bus mes- 
sages that contain a primary address if the primary 
address agrees with the value selected. This address 
selection permits the Plotter to be uniquely addressed 
by the bus controller in a GPIB system consisting of 
several devices. 


INTERFACE MODE LINE 


Selections made on the Interface Mode line either (1) 
permit the programmable configuration of the system 
where the controller assigns listeners and talkers 
(normal), or (2) perform a manual! configuration of the 
Plotter as a listener or as a talker (Listen Only, Talk 
Only). 


INTERFACE FUNCTIONS LINE 


The selection of CR GENERATES LF permits the 
interface to automatically generate a line feed charac- 
ter following each carriage return character that is sent 
to the Plotter for printing. Use this function if the data to 
be printed does not contain line feeds following each 
carriage return. 


NOTE 


The 4050 Series Graphic Systems do not auto- 
matically generate a ‘s character when sending 
print data. Thus, select the CR GENERATES LF 
function when communicating with these con- 

trollers. 
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COMMUNICATING WITH OTHER DEVICES 


The following pages describe how devices instruct the 
Plotter to transmit or receive data bytes and how the 
Plotter interacts with a GPIB controller to change or 
report its status. These actions are described both in 
terms of the GPIB functions required by the Plotter 
interface and, for TEKTRONIX 4050 Series Controllers, 
the typical commands the controller uses to command 
the required GPIB functions. Refer to the specific 
operator’s manual for controllers other than the TEK- 
TRONIX 4050 Series to see how the needed GPIB 
functions are commanded. For precise details about 
GPIB operation, refer to both the IEEE Standard 488- 
1978 and Appendix E. 


GPIB OPERATION 


The GPIB allows data bytes, which consists of com- 
mands and responses, to be transmitted through the 
bus from a single ta/ker (a data byte transmitter) to one 
or more listeners (data byte receivers). The designation 
of the talker and listener on the bus can be changed to 
allow data byte transfer between any connected 
devices. This designation either is changed for each 
data byte or remains in effect for an extended period to 
allow the transfer of many data bytes. 


The designation of the talker and listener devices is 
done under control of a system controller. The controll- 
er uses special bus functions to designate the desired 
talker and listener(s), to initiate or interrupt the 
transmission of data bytes between devices, and to 
determine the status of the devices in the system. An 
example of a device with controller capability is the 
TEKTRONIX 4050 Series Graphic System. For systems 
that do not have a controller, the designation of the 
Plotter as a talker and listener and the initiation of data 
byte transfers are done manually through the Plotter’s 
Parameter Entry Card and front panel functions. 
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INTERFACE SWITCHING FUNCTION 


The Interface Switching function provides a flexible, 
manual means to control the Plotter’s response to 
messages on the GPIB. Two front panel switches of the 
Plotter (OFFLINE/ONLINE and LOCAL/REMOTE) 
provide four different conditions for the Interface 
Switching function: Online/Remote, Online/Local, 
Offline/Remote, Offline/Local. 


Online/Remote 


This is the normal mode of operation and is automati- 
cally selected upon power-up. The Plotter receives all 
bus messages and executes received commands. 


Online/Local 


The Plotter receives all bus messages but ignores all 
commands received. This mode permits plotting to be 
inhibited without stopping GPIB communication when 
the controller expects a device at the current Plotter 
address. 


Offline/Remote 


The Plotter ignores all GPIB messages. This mode is 
equivalent to removing the GPIB cable from the Plotter. 


Offline/Local 


The Plotter ignores all GPIB messages. This mode is 
equivalent to removing the GPIB cable from the Plotter. 
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DEVICE-TO-PLOTTER TRANSMISSION 


The following paragraphs describe the actions required 
to transfer commands (in the form of data bytes) from a 
talker to a Plotter acting as the listener. The temporary. 
storage of Plotter commands is also described. 


The Plotter As a Listener 


The controller directs the Plotter to listen by sending 
the ATN (Attention) and the MLA (My Listen Address) 
bus messages at the same time. The MLA message 
contains a device address that must correspond to the 
device address specified on the Paramenter Entry 
Card. Refer to Figure 5-3 for a chart of GPIB message 
bytes. 


Once the Plotter is addressed as a listener, device 
dependent messages consisting of Plotter commands 
are sent as data bytes (DABs) from the talker to the 
Plotter (listener). The EOI (End Or Identify) bus 
message sent with the last DAB indicates that the 
message is complete and terminates the last command 
of the message. 


After all commands are sent to the Plotter, the controll- 
er may cancel the Plotter’s listen function by sending 
the ATN and the UNL (unlisten) messages at the same 
time to the Plotter. 


DAB Commands From a Controller. Here, data bytes 
{(DABs) containing the command code and arguments 
are transmitted from the controller (acting as a talker) 
to the Plotter. For example, to transfer a DRAW 
command to the Plotter from a 4050 Series controller, 
the following basic statement is executed by the 
graphic system: 


PRINT @1,32: “D50,50”; 


This statement has the 4050 Series Controller send the 
ATN and MLA 1 bus messages at the same time, which 
enables a Plotter having Device Address 1 to be the 
listener. The controller is then automatically enabled as 
the talker with the data bytes D50,50 transmitted 
through the GPIB to the Plotter. The EOI (End Or 
Identify) bus message is sent with the last data byte to 
tell the Plotter that the transmission is complete. The 
controller then sends UNT (Untalk) and UNL (Unlisten) 
messages to cancel the established talker and listener 
functions. 
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NOTE 


The 4050 Series Graphic System functions as 
both a controller and a talker. Refer to the Print 
and WByte statements and to the Interfacing 
Information appendix (located in the 4050 Series 
Graphic System Reference Manual) for further 
discussion of these actions. The actual transmit- 
ted data bytes that define a specific command 
are discussed under Introduction to GPIB Com- 
mands in this section. 


MSA Commands From a Controller. An alternative 
specification for the DRAW command to be transmitted 
from the 4050 Series Graphic System would be: 


DRAW @1:50,50 


This example has the 4050 Series controller send the 
ATN and MLA 1 bus messages at the same time and 
then follows with the MSA 20 (My Secondary Address 
20) message while the ATN message is still true. The 
MLA 1 message enables a Plotter having Device 
Address 1 to be a listener. The MSA 20 message is 
equivalent to the D command code for the DRAW 
command shown in the previous example. This 
nonstandard use of the MSA message is unique to the 
4050 Series Graphic System. Refer to /ntroduction to 
GPIB Commands in this section for a discussion of 
Plotter commands having equivalent MSA definitions. 
The remainder of the statement is processed as in the 
previous PRINT @1,32: statement used to transfer the 
DRAW arguments of 50,50 to the Plotter. 


As long as the Plotter remains enabled as a listener, 
several commands in succession can be transmitted 
from the talker to the Plotter. 


NOTE 


The talker could be a device other than the 4050 
Series Graphic System, such as a GPIB mass 
Storage device. Here, the controller enables the 
mass Storage device as the talker and allows it to 
transfer a plot to the Plotter. When the transfer is 
completed, the controller cancels the talker and 
listener functions. 
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Figure 5-3. GPIB Code Chart. 
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Offline Plotting. You can transfer a plot to a Plotter 
without a controller connected to the GPIB. A typical 
system involving a TEKTRONIX 4924 Digital Cartridge 
Tape Recorder and a Plotter is shown in Figure 5-4. To 
transfer a plot, enable the Plotter as a listener by 
selecting LISTEN ONLY on the Interface Mode line of 
the Parameter Entry Card. The desired tape file should 
be located on the 4924’s tape cartridge. The 4924 is 
then enabled as a talker by pressing the TALK button 
on the 4924 front panel (the 4924’s ONLINE button 
should be in the out position). The contents of the 
desired tape cartridge file will be transferred to the 
Plotter. 


NOTE 


When the plotter is in LISTEN ONLY mode, it does 
not require an MLA message with a device 
address that corresponds to its address. The 
Plotter will interpret all data bytes seen on the 
GPIB as commands. Therefore, other devices 
should not exchange data while the Plotter is 
connected to the bus in LISTEN ONLY mode. 


PLOTTER 


TEKTRONIX z 


4924 


Figure 5-4. Typical OFFLINE Configuration. 





Input Buffering 


As commands are received from the talker, they are 
placed temporarily in an input buffer of the Plotter’s 
memory. (Temporary storage is needed when com- 
mands are received faster than the Plotter can execute 
them.) When the Plotter is ready for another command, 
commands are withdrawn from the input buffer and 
executed. The following describes: 


@ How the input buffering function operates. 


@ How much memory is needed to store a Plotter 
command. 


@ How much memory is available under various condi- 
tions to store commands. 


Buffer Operation. Because the GPIB is a handshake 
bus, data bytes transfer only at the speed the talker or 
listener devices can handle. If the Plotter is busy 
processing previous commands and cannot read the 
data bytes as fast as they are being transmitted by the 
talker, the data byte transfer automatically halts until 
the Plotter is ready. However, this action ties up the 
GPIB so that the controller cannot talk to other devices. 
When the Plotter has completed its processing and is 
waiting for the pen to finish its current motion, 
additional commands are received from the interface 
and stored in the input buffer. When all data bytes in 
the plot have been received from the talker, the 
controller can reconfigure the bus to talk to other 
devices while the Plotter is executing the buffered 
commands. 


NOTE 


The buffering is done only after the Plotter 
completes its command processing and is wait- 
ing for pen motion to finish. Therefore, when the 
Plotter is executing mostly nonmotion commands 
or short-motion commands (which require almost 
continuous processing), there is little buffering 
done. 
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Commands are received from the interface as data 
bytes. For Plotter commands, these data bytes are 
ASCII characters that comprise the command code and 
arguments of the Plotter commands. The interface 
converts commands expressed as ASCI! characters 
into a corresponding interna! form. Any interface 
commands are executed at once (refer to Section 8 for 
a listing of these commands), All other commands are 
stored in the input buffer. 


Storage Requirements for Commands. All commands 
are received by the Plotter in the various command 
forms described under /ntroduction to GPIB 
Commands And Responses, later in this section. 


The internal form into which the Plotter commands are 
converted requires the following storage in the input 
buffer: 


®@ Two bytes of storage for each command code, PLUS 
@ One byte of storage for each character argument, 


@ And five bytes of storage for each numeric argu- 
ment. 


For commands with string arguments, a separate 
command is formed for each string character. For 
commands that have the command code followed by 
multiple groups of arguments, a separate command is 
formed for each argument group. 


The internal form for each command is the same 
regardless of the command format used to transmit the 
command to the Plotter. For some cases, this means 
that more bytes of memory are needed for a command 
stored in the input buffer than it took characters to 
transmit the command to the Plotter. The ratio of these 
respective number of characters is defined as the 
internal expansion factor. 


The following examples show different internal expan- 
sion factors: 


@ An alpha character takes one character to express 
and three bytes to store, giving an internal expan- 
sion factor of 3. 


@ Atypical DRAW command, D 100,10 takes seven 
bytes to express and twelve bytes to store, giving a 
1.7 internal expansion factor. 
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Memory Limits for the Input Buffer. The Plotter 
memory available for buffer operation is used in two 
ways. First, some memory always establishes a 
minimum size for the input buffer. Second, the remain- 
ing memory is used on a “first come, first served” basis 
for (1) the expansion of the input buffer to store 
additional input commands, (2) the temporary buffering 
of responses formed by output generating commands, 
and (3) longer term storage for the following types of 
data: 


@ Graphic transform levels saved by a SAVE CUR- 
RENT TRANSFORM command. 


@ Programmable macros defined by Macro commands 
(available with Option 31 only). 


@ Downloadable characters defined by Downloadable 
Character commands (available with Option 32 
only). 


Refer to the individual command descriptions to deter- 
mine the amount of memory space required for 
command storage. When stored data is subsequently 
deleted, allocated memory for that data becomes 
available again for other uses. 


While a programmable macro or downloadable charac- 
ter definition is in process or if most available memory 
has stored programmable macros or downloadable 
characters, the input buffer is forced to assume its 
minimum size. The number of commands stored while 
in this minimum size depends upon the command type. 
For example, about 200 PRINT CHARACTER com- 
mands or about 50 MOVE and/or DRAW commands 
can be stored. The number of external characters 
required to define these commands depends upon the 
command style being used. If no transforms, pro- 
grammable macros, or downloadable characters are 
defined and no output responses are stored, then the 
input buffer expands to a maximum size. In a standard 
Plotter with 8K of memory, approximately 340 MOVE 
and/or DRAW commands or 1360 PRINT CHARACTER 
commands are storable. 


NOTE 


When you initialize the interface by the front 
panel Initialize function, the input buffer is 
cleared. 
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PLOTTER-TO-DEVICE TRANSMISSION 


The Plotter transmits several types of information to 
other devices. The following pages discuss the 
transmission of output information and include: 


® How responses generated by Plotter commands are 
temporarily buffered. 


@ How these responses are transmitted (as data 
bytes) from a Plotter acting as a talker to a listening 
device. 


Output Buffering 


Plotter output (which is responses formed by Plotter 
commands) is transmitted in the form of output blocks. 
Each output block contains two numeric response 
values plus a numeric TAG value. Refer to Introduction 
to Serial Commands and Responses in this section for 
a description of the output blocks. 


Only one output block is generated for commands 
whose response consists of one value (such as the 
READ FORM LENGTH command) or two values (such 
as the DIGITIZE command). Two or more output blocks 
are generated for commands that return more than two 
values. The size of these output response blocks may 
vary from 23 to 35 data characters, depending upon 
the numeric values of the responses. As the output 
response blocks are generated, they are are stored in 
the Plotter’s memory until transmission is initiated. 
Refer to the command description sections for a 
discussion of the response values set up for each 
output generating command. 


NOTE 


The Plotter memory required to store output 
blocks reduces the amount available for input 
command storage, programmable macros, down- 
loadable characters, and transforms. Thus, the 
buffering of output responses should be kept toa 
minimum. 
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Normally the response to one output generating com- 
mand is read by the controller before another output 
generating command is received by the Plotter. Enough 
memory is always reserved for output buffering so that 
a single output response can be buffered even if all the 
remaining memory has been allocated to other func- 
tions. 


A maximum of 127 response blocks can be stored if 
memory is available. The amount of buffer space 
needed to store the responses is the sum of the 
number of bytes in each response block plus one byte 
per output block. Because memory is allocated to 
buffering functions in 62-byte increments, you can 
determine the number of memory bytes required to 
store this number by rounding the number of bytes up 
to the next multiple of 62. The output buffer is cleared 
with the front panel Initialize function. 


The Plotter As a Talker 


The controller directs the Plotter to become a talker by 
sending the ATN (Attention) and MTA (My Talk 
Address) bus messages at the same time. The MTA 
message contains a device address that must corre- 
spond to the selected address for the GPIB Device 
Address line on the Parameter Entry Card. Refer back 
to Figure 5-3 for a chart of GPIB message bytes. 


Once the Plotter is addressed as a talker and the bus 
indicates that a device has been addressed as a 
listener and is ready to receive, the Plotter begins to 
transmit bytes from the output buffer as bus data bytes. 
The Plotter transmits one output block from the output 
buffer followed by an output termination sequence 
(defined by the current Command/Response Format). 
Transmission then ceases until another MTA bus 
message is received. If the output buffer is empty, the 
bus pauses until output is generated. 
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The output termination sequence informs the controller 
that the last byte of the output block was transmitted 
by the talker and that the bus can be reconfigured for 
another use. The termination sequence also identifies 
the last data byte to the listener, so that the listener 
can perform any required end-of-transmission tasks 
(such as closing files). Different controllers and listen- 
ers look for different terminations. The most common 
terminations are: 


@ Where the EO! bus message is sent with the last 
data byte transmitted. 


@ Where the transmission is terminated by a carriage 
return or a Carriage return followed by a line feed. 
For some GPIB devices the EO! bus message sent 
with the line feed may not be required. 


For the first type of termination, the last data byte is 
included in the transmission. For the second type of 
termination, the termination characters are discarded 
when received by the listener. These two types of 
termination requirements are satisfied by the two 
Plotter output terminators that you select: 


@ The EOI bus message sent along with the last data 
byte of the message 


® Acarriage return followed by a line feed sent with 
the EOI bus message. 


The termination used is specified by the current 
Command/Response format specification. 


Online Digitizing Example. To cause a single digitize 
response to be generated and transferred to a 4050 
Series Graphic System, the following BASIC state- 
ments would be executed by the Graphic System: 


PRINT @1,32:G”; 
INPUT @1,32: X,Y,T 


During execution of the PRINT statement, the 4050 
Series controller sets the Plotter at Device Address 1 
as the listener (with the MLA 1 and ATN bus messages) 
and then sends the “'G” (digitize) command code. Next, 
the controller cancels the listen function with the UNL 
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bus message and sends the MTA 1 and ATN messages 
to enable the Plotter as a talker. The Plotter processes 
the “G” command code and generates an output block 
consisting of the desired XY coordinates and the 
associated TAG value. 


The three values in the output block are converted into 
ASCII Decimal Floating Point numbers and entered into 
the output buffer. Command/Response Format 1 is 
used for 4050 Series Controllers. Thus, the values are 
then transmitted with the EOI bus message sent with 
the last data byte. The 4050 Series Controller reads 
these data bytes and assigns values of the numbers to 
the three target variables (X, Y, and T) in the INPUT 
BASIC statement. The 4050 Series Controller then 
sends the UNT and the ATN bus message to cancel the 
Plotter talk function. Manually digitized coordinates 
could be returned in a similar fashion by using the 
OPERATOR DIGITIZE ENABLE command (refer to SRQ 
and Serial Poll Actions later in this section. 


Offline Digitizing Example. You can manually transfer 
digitized coordinates from the Plotter to a storage 
device offline without a controller connected to the 
GPIB. A typical system involving a TEKTRONIX 4924 
Digital Cartridge Tape Recorder and the Plotter is 
shown in Figure 5-4. To transfer digitized coordinates, 
enable the Plotter as a talker by selecting TALK ONLY 
on the Paramenter Entry Card. You mut also select 
Command/Response Format 1. The desired tape file is 
located on the 4924’s tape cartridge and the 4924 is 
enabled as a listener by pressing the LISTEN button on 
its front panel (the 4924’s ONLINE button should be in 
the out position). Using the Plotter’s front panel Move 
Point or Draw Point functions, digitized coordinates are 
generated, transferred to the 4924, and stored on the 
tape cartridge. The Last Point function generates the 
final coordinate and the final output termination se- 
quence causes the 4924 to close the tape file. 


NOTE 


When the 4663 Plotter is in Talk Only mode, the 
EO! Bus Message is sent only when the Last 
Point function is used. 
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INTERACTING WITH THE CONTROLLER 


The previous topic described the exchange of DABs 
between a listener and a talker via the GPIB. Informa- 
tion here describes Plotter related details of some 
functions performed by the controller to set up and 
terminate these exchanges. 


Interrupting Data Exchanges 


\f a controller needs to interrupt the talker/listener’s 
use of the GPIB, you must direct the controller to send 
the ATN bus message along with the UNT and the UNL 
bus messages. This cancels the talker and listener 
functions and permits the controller to send other 
messages on the bus. Once the controller is finished 
with the bus, the ATN bus message, plus the MTA amd 
MLA bus messages will reestablish the original 
talker/listener exchange. The Plotter allows exchanges 
to be interrupted and reestablishd, either as a listener 
or as a talker, except when the current Com- 
mand/Response Format is 5 or 6. For these formats, a 
UNL message, received while a string argument is 
being received, will terminate the string argument. If the 
termination was premature, a UNL message causes 
undesired results. 


IFC (Interface Clear) Actions 


Often, it is desirable to force interfaces of GPIB devices 
to a Known state. Before beginning a new operation, the 
controller forces the interfaces of all devices on the 
GPIB to a nonactive state simultaneously by sending 
the IFC (interface clear) message. For the Plotter, the 
IFC message causes any listener, talker, or serial poll 
actions to be cancelled. If the current Com- 
mand/Response Format is 5 or 6, a Device Clear 
function is also performed. For other Com- 
mand/Response Formats, the input or output buffers 
are not cleared. 
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The IFC message can occur at any time. To be sure of a 
response under all conditions, the IFC message should 
be asserted for at least 300 wsec (there should be a 
delay of about 200 usec after the IFC message is 
removed before new GPIB messages are transmitted). 
While the IFC message is asserted, the Plotter ignores 
all GPIB commands except DEVICE CLEAR. 


These actions are required due to hardware limitations. 
The Plotter may not recognize an IFC message that is 
asserted for only the minimum time required by IEEE 
Standard 488-1978 (100 nsec). The Plotter may not 
respond to an IFC message within the maximum time 
required by IEEE Standard 488-1978 (100 wsec). 


DCL/SDL Actions (Device Clear/Selected 
Device Clear) 


The DCL bus message (sent along with the ATN 
message) performs four functions: 


@ Causes the input and output buffers to be cleared 
(including clearing any partial commands received). 


® Cancels any SRQ message. 


@ Cancels any Operator Digitize Enable (if the initial 
Command/Response Format is 5 or 6, and the 
Operator Digitize function is permanently enabled). 


@ Turns off the Plotter’s POINT light. 


The DCL bus message performs similar functions to all 
devices connected to the GPIB. The SDC message 
performs the Device Clear function only on the device 
addressed by the MLA message. (The SDC message 
must be preceeded by a MLA and ATN message and be 
sent with an ATN message.) 
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SRQ (Service Request) and Serial Poll 
Actions 


Another general function of the GPIB controller is to 
respond to asynchronous requests for service from 
devices on the GPIB. Devices on the GPIB can request 
service by sending an SRQ message. If the controller 
has enabled this function, the SRQ message interrupts 
the controller's current task. The controller must then, 
if there is more than one possible request, determine 
what action is being requested. To do this, the 
controller performs a Serial Poll function, which reads a 
status byte (the Serial Poll Response Byte) from each 
device on the GPIB. A bus device indicates that it is 
sending the SRQ message by setting Bit 7 (Service 
Request) in its Serial Poll response byte. Other bits in 
the Serial Poll response byte then indicate which of the 
possible requests for that device are active. AS soon as 
the Serial Poll response byte (which contains the 
active Service Request bit) is read, the device stops 
transmitting the SRQ messages. The Service Request 
bit of the Serial Poll response byte remains active until 
the condition which generated the request is satisfied. 


The only condition that causes the service request bit 
to be set is when an output block (generated by the 
Operator Digitize function) is ready to be read. The 
remaining bits in the Serial Poll response byte are not 
used. The value of the Serial Poll response byte can be 
either O or 64 (decimal). Thus, the SRQ message is 
transmitted when one of the front panel Point functions 
generates a set of digitized coordinates. The Service 
Request bit remains asserted as long as any sets of 
digitized coordinates in the output buffer are waiting to 
be read. Refer to Section 13 for more information on 
the Digitize function. The Plotter responds to a Serial 
Poll function when NORMAL or TALK ONLY has been 
selected on the Interface Mode line of the Paramenter 
Entry Card, but not when LISTEN ONLY is selected. 
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The SRQ function allows digitized points to be read 
from the Plotter without tying up the GPIB by waiting 
for the next points to be generated. For example, the 
short program for a 4050 Series Graphic System 
shown in Figure 5-5 uses the SRQ function to read 
digitized points into the graphic system while the main 
program performs other processing. When a Last Point 
is digitized, all previously digitized points are displayed. 


Alternatively, digitized input can be read directly by the 
main program. An example of this operation appears in 
the short program for a 4050 Series Graphic System 
shown in Figure 5-6. Here, the GPIB halts until 
coordinates are generated. For controllers that 
recognize SRQ messages, this function must be dis- 
abled or a dummy Service routine added to reset the 
response to the SRQ message (if this mode of coordi- 
nate input is desired). 


If the digitized point is requested by a CALL DIGITIZE 
command rather than by an INPUT command, then the 
Operator Digitize function does not always generate 
the SRQ messages (as required for TEKTRONIX 4662 
compatibility). 


If the CALL DIGITIZE command has already addressed 
the Plotter as a talker when the digitize coordinates are 
generated, then the response is transmitted without the 
SRQ message being sent. However, if the next coordi- 
nate is generated before the Plotter is addressed as a 
talker again, then the SRQ message would be sent. 


GPIB INTERFACE 
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REM PROGRAM FOR DIGITIZING USING THE SERVICE REQUEST FUNCTION 
REM 

REM INITIALIZATION 

REM ISSUE IFC BUS MESSAGE TO RESET THE INTERFACES 

INIT 

REM DO A DEVICE CLEAR TO CANCEL ANY PREVIOUS SRQS 

WBYTE @22: 

REM DEFINE STORAGE FOR THE DIGITIZED POINTS 

DiM X25 0--¥ €25 22625) 

REM CLEAR STORAGE 

X= 

Y=@ 

Z=@ 

REM INITIALIZE DIGITIZED POINT INDEX 

I={ 

REM ENABLE PLOTTER DIGITIZING FOR 25 POINTS 

PRINT @1,32:"AG"; 25 

REM ENABLE SRQ SERVICING 

ON SRQ THEN 369 

REM START THE MAIN PROGRAM 

REM 
REM MAIN PROGRAM 
REM 
REM OTHER PROCESSING COULD BE PERFORMED HERE 
REM DUMMY PROGRAM 

GO TO 35@ 

REM 
REM SRQ SERVICE ROUTINE 
REM 
REM DO SERIAL POLL TO DETERMINE STATUS 

POLL A,B;1 

REM SERVICE PLOTTER UNTIL SERVICE REQUEST STATUS IS @ 
IF B<>@ THEN 440 

RETURN 

REM DIGITIZE NEXT POINT 

PRINT 64, 32e"C? 

INPUT G4), 322 X C195 0CL), ZC 28) 

REM CHECK FOR LAST POINT 

IF Z(I)=2 OR 2Z(1)=3 THEN 522 

REM COUNT POINT AND CONTINUE SERVICING 

T=I+1 

GO TO 482 

REM PLOT POINTS WHEN LAST POINT RECEIVED 

AOR J=)] 2G) J 

IF Z(J)= @ THEN 572 

MOVE XG3) 4 ¥ Gel) 

GO TO 582 

DRAW X(J),Y(J) 

NEXT J 

END 








Figure 5-5. Operator Digitized Input Using the SRQ Function. 
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REM PROGRAM FOR DIGITIZING NOT USING THE SERVICE REQUEST FUNCTION 
REM 

REM INITIALIZATION 

REM ISSUE IFC BUS MESSAGE TO RESET THE INTERFACES 
INIT 

REM DO A DEVICE CLEAR TO CANCEL ANY PREVIOUS SRQS 
WBYTE @2@: 

REM DEFINE STORAGE FOR THE DIGITIZED POINTS 
DIM X25), YC2502(255 

REM CLEAR STORAGE 

X=0 

Y=2 

Z=0 

REM INITIALIZE DIGITIZED POINT INDEX 

I=] 

REM ENABLE PLOTTER DIGITIZING FOR 25 POINTS 
PRINT @1,32:"AG"; 25 

REM SATISFY SRQ SERVICING REQUIREMENTS 

ON SRQ THEN 492 

REM START THE MAIN PROGRAM 

REM 

REM MAIN PROGRAM 

REM 

REM DIGITIZE NEXT POINT 

PRINT @1,32:"C" 

REM PAUSE HERE FOR INPUT 

LNPUT 41, 82:X0 1), ¥CI Ze) 

REM CHECK FOR LAST POINT 

IF Z(I)=2 OR Z(1)=3 THEN 41 

REM COUNT POINT AND CONTINUE SERVICING 
T=I+1 

GO TO 3308 

REM PLOT POINTS WHEN LAST POINT RECEIVED 
FOR J={ TO I 

IF Z(J)= @ THEN 462 

MOVE X(J),Y(J) 

GO TO 472 

DRAW X(J), YJ) 

NEXT J 

END 

REM DUMMY SRQ SERVICE ROUTINE 

RETURN 


3806-30 





Figure 5-6. Operator Digitize Input Without the SRQ Function. 
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INTRODUCTION TO GPIB COMMANDS AND RESPONSES 


A wide range of command and argument forms permit 
communication with devices having varying output and 
input capabilities. The actual form of the commands 
and responses to be used is determined by the current 
Command/Response Format selection. Refer to Setting 
Up the Parameter Entry Card (previously described in 
this section) for help in selecting an appropriate 
Command/Response Format. 


The following pages describe the structure of the 
actual commands sent over the GPIB to the Plotter. The 
user must refer to the specific device’s manual to 
determine how transmission of these command forms 
is done over the GPIB. Some examples showing 
generation of these commands by a 4050 Series 
Graphic System will be shown and may give some 
guidance for the generation of Plotter commands by 
other devices. 


NOTE 


For GPIB Commands/Response Format 7, refer to 
the structure of the commands under Introduction 
to Serial Commands and Responses later in this 
section. 


PLOTTER COMMANDS 


The general command form recognized by the GPIB 
interface is: 


< Command Code> <Arguments> 


Each portion of these commands is discussed along 
with any separators and terminators required to cor- 
rectly punctuate the commands. Also presented is the 
Plotter’s reaction to incomplete or unrecognized 
commands. 
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Command Code 
The command code consists of one or two ASCII - 
characters (either uppercase or lowercase) that 
uniquely identifies the command. The command code 
for each Plotter operation is defined in the command 
description sections of this manual. For Com- _ 
mand/Response Formats 3 or 4, the command code 
can be followed by a space character used as a 
delimiter. For all formats where the command is not a al 
PRINT or PRINT CENTERED CHARACTER command, 
optional carriage return or line feed characters follow- 
ing the command code are discarded. 
ee! 
NOTE 
The single letter commands A or C (or D if null 
arguments are specified) should always be fol- al 
lowed by a command terminator to ensure correct 
interpretation of the commands. (See NULL Argu- 
ments later in this section. 
= 


Arguments 


Any arguments defined for a particular command follow wy 4 
the command code. Specific arguments for each 

command are defined in the command description 

sections of this manual. Command arguments can be of 

two general types: numeric or string. Individual argu- — 
ments are partitioned from each other by argument 

separators and the end of the argument set is marked 

by a command terminator. Refer to Argument Separa- 

tors and Command Terminators later in this section. = 


Numeric Arguments. Numeric arguments are ex- 

pressed in any of three standard forms: integer, floating = 
point, or scientific notation. Examples of each form are 

shown below: 


@ —15 integer = 
@+158 floating point 
@ 1.58E+01 scientific notation (E format) 
oe 
a 
= 
— 
= 
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When entering numeric arguments, follow these rules: 


@ When a numeric argument is positive, the “+ ” sign 
is optional. 


@ Leading zeros are ignored. 


@ In the scientific notation form, express the mantissa 
as in an integer or floating point form. 


® The E is either uppercase or lowercase, and the 
exponent is expressed as 1 or 2 digits. 


@ A‘‘+” sign is not required if the exponent is positive. 


@ A space character can be substituted for a “+” sign 
in either the mantissa or the exponent. No other 
spaces should appear within the argument. 


@ Numeric arguments are always terminated by any 
character that is not part of a specified numeric 
form. (For example, a character which is not one of 
the digits O through 9 and the characters+ —eE 
and a period.) 


These numeric argument forms accomodate the num- 
ber formats specified in ANSI Standard X3.42. The 
units, resolution, and allowable range of numeric 
arguments are unique to each command and are noted 
in the command description sections. 


One special type of numeric argument is a selector 
argument used to specify one of a set of prenumbered 
choices defined for some commands. For Formats 5 
and 6, leading “‘?” or “=” characters before a numeric 
argument are ignored. 


String Arguments. A string argument represents a 
sequence of one or more ASCII characters in one of 
three forms: 


@ Asa “delimited string” 
@ Asan “undelimited string” 


@ A special form of “print string” is required for PRINT 
or PRINT CENTERED CHARACTER command argu- 
ments when the Command/Response Format is 1, 2, 
5, or 6. 


The delimited string form is described first. The 
following shows three simple examples with each 
representing the ASCII character A. 


e A” 
e@ 'A’ 
@ /65 
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A delimited string can be formed by preceding and 
following a group of one or more ASCII characters by 
the same delimiter (either ‘ or ” ). Alternatively, a 
delimited string may consist of a / (slant character) 
followed by the numeric argument that is equal to the 
ADE (ASCII Decimal Equivalent) value assigned toa 
given ASCII character. The ADE values for each ASCII 
character are shown in the ASCII Code Chart Appendix 
B. The delimited string representation is used to 
specify any ASCII characters with the exception of the 
string delimiter character(s) that cannot be sent by the 
device transmitting the Plotter commands. The ADE 
representation is used for any ASCII character. The two 
representations can be mixed to form a single, more 
complex delimited string. 


Here are additional examples of delimited strings: 


Characters 
Delimited String Represented 
“ABC” ABC 
*AB’/13/10’CD” ABSrtFCD 


*HeSpsaid:Sp‘ISpcan’”’”"'t' HeSpsaid:§p"|Spcan't” 
String arguments can also be in the undelimited string 
form. An undelimited string is a sequence of ASCII 
characters, where the first character cannot be any of 
the following characters: 


fo BES Sp eR ae. Fs 


After the first character, the string can contain any 
character. An undelimited string is terminated either by 
an ©x character or by the EOI bus message received 
with the last byte of the string. In Formats 5 and 6, the 
UNL bus message also terminates these strings. 


Print strings are special string arguments that are used 
in Command/Response Formats 1, 2, 5, and 6 as the 
arguments for PRINT or PRINT CENTERED commands. 
These strings begin immediately following the com- 
mand code and can contain any ASCII character. 
These strings are terminated the same as undelimited 
Strings. 
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Argument Separators and Command 
Terminators 


Argument separators are special sequences of charac- 
ters that define the end of one argument and the 
beginning of the next. A space or a comma is the most 
common argument separator. However, an argument 
separator can also be expressed in one of two more 
general forms: 


@ A sequence of one or more space, carriage return, or 
line feed characters. 


@ A sequence of zero or more space, carriage return, 
or line feed characters followed by a comma, 
followed by another sequence of zero or more space, 
carriage return, or line feed characters. 


NOTE 


The argument separator implies that another 
argument follows (if it is allowed). Thus, be sure 
that the last argument of a command is not 
followed by a space er comma character (which 
would be interpreted as an argument separator). 


A command terminator is a character that marks the 
end of the command’s last argument and indicates that 
no more arguments follow. A command is not executed 
by the Plotter until it has been terminated. There are 
two general types of command terminators: discarded 
and reprocessed. 


Discarded command terminators explicitly delimit the 
command and, after they are recognized, are discarded 
without further interpretation. The discarded type com- 
mand terminators are the semicolon and the EOI bus 
message sent together with the last byte of the 
command. 


Reprocessed command termination characters termi- 
nate a command but are also then reprocessed as part 
of a following command. An example is when the 
command code for one command terminates the previ- 
ous command. 


Be sure that the last argument of a command is 
properly terminated. For example, a command code 
that terminates a numeric argument may not terminate 
a string argument. Various types of string arguments 
require their own terminators. 
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NOTE 


In Formats 5 and 6, commands that have no 
arguments require no command terminators. In 
Formats 1, 2, 3, or 4, a command terminator with 
these commands is optional. 


Multiple Argument Groups 


A complete set of arguments for a command is defined 
aS an argument group. For some commands, more than 
one argument group can follow the command code 
when multiple occurrences of the command are de- 
sired. For example, the DRAW command can be 
followed by multiple pairs of X,Y coordinates. The final 
argument group is followed by a command terminator. 
The commands that allow multiple argument groups are 
described in the command description sections. 


NOTE 


Commands allowing multiple argument groups 
should be carefully terminated. For example, if a 
space or comma character appears following the 
command, more arguments are assumed, causing 
undesired results. 


NULL Arguments 


A NULL argument can be specified in place of an 
expected numeric or string argument. A NULL numeric 
argument is given an O value and a NULL string 
argument is given a value of a single ASCI] NULL 
character Nu. NULL argument values are established by 
simply not specifying the argument and including only 
the argument separator (or terminator). 


NOTE 


The argument separators being used to specify 
NULL arguments must be unique. For example, 
two consecutive commas specify a NULL argu- 
ment, but two consecutive spaces do not. For 
Command/Response Formats 3 or 4, a space 
following a command code is interpreted as a 
command code delimiter and not an argument 
separator defining a NULL argument. Thus, the 
argument separator must be a comma if a leading 
NULL argument is to be specified. NULL argu- 
ments are not allowed when using 
Command/Response Formats 5 or 6. 
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Optional Arguments 


Some Plotter commands have optional arguments, 
which appear at the end of the argument list. These 
optional arguments are eliminated by entering a com- 
mand terminator instead of a command separator 
before the optional argument position. The effects of 
optional argument selection in such commands are 
discussed in the individual command description sec- 
tions. 


NOTE 


Optional arguments must be entered when using 
Command/Response Formats 5 or 6. 


Command Interpretation 


Errors in forming communications commands may 


cause the Plotter to receive unrecognizable commands. 


The following outlines the Plotter’s response to these 
commands: 


®@ |f the command code is not recognized, then an 
Unrecognized Command error is generated and any 
following command arguments are discarded until 
the command is terminated. An undelimited string 
argument will terminate the discarded command. 


@ Errors in argument specifications (which cause a 
delimited string argument to be recognized when a 
numeric argument was expected) cause an Argu- 
ment Type error to be generated and the command 
discarded. 


@ Anumeric argument is interpreted as an undelimited 
string argument if a string argument is expected. 


@ A undelimited string argument is interpreted as a 
command terminator if a numeric argument is 
expected (unless the undelimited string is a num- 
ber). 
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When an error is made while sending a command to the 
Plotter, a command termination should be sent before 
beginning another command. If the command code had 
been entered, then the partial command is executed 
using any arguments specified and assuming NULL 
arguments for the remainder. Careful termination of 
commands assists in the recovery from command 
specification errors. 


OUTPUT RESPONSES 


Output generating Plotter commands cause one or 
more output blocks to be created. The following 
paragraphs describe how the listening device should 
decode these output blocks to obtain the desired 
information. 


Each output block setup by a Plotter command con- 
sists of two 16-bit data values and a TAG value (except 
for the READ STATUS command response in Com- 
mand/Response Formats 5 and 6, which returns only 
one data value). For most commands, the two data 
values are obtained from encoding several pieces of 
requested information. The information can be decoded 
from the data values by reversing the encoding 
process. The encoding process for each output gener- 
ating command is described in the command descrip- 
tion sections. The meaning of the TAG value is 
explained for each output generating command in the 
command description sections. 


In forming output blocks, the two data values and the 
TAG value are converted to ASCII decimal numbers in 
scientific notation with each value separated by com- 
mas and then transmitted through the output buffer. 
Refer to Plotter-To-Device Transmission, earlier in this 
section for more information. 
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For example, Figure 5-7 shows a short program for a 
4050 Series Graphic System that determines the 
media type status returned by a READ STATUS 0 
command response. Figure 5-8 shows another example 
of how to decode an IDENTIFY command response. 
Both examples use Format 1. 


The listening device can use the TAG value to 
determine when the last output block of a multiple 
block response has been received. In Format 1,a TAG 
value of 2 or 3 indicates that the block is the last block 
of the response. 


For example, ina READ MACRO STATUS command, 
the number of blocks transmitted depends upon the 
number of macros currently defined. The final block of 
this response is identified by a particular value of the 
TAG number. (Refer to the READ MACRO STATUS 
command in Section 14 for more details on the 
response encoding.) 


In Figures 5-7 and 5-8, the X, Y, and Z variables of the 
INPUT statements are the target variables whose value 
will be established by the three values contained in the 
desired response. 


REM PROGRAM TO CHECK FOR ROLL OR SHEET MEDIA 
REM 
REM SEND A READ STATUS @ COMMAND 
PRINT @1,32:"V@" 

REM READ RESPONSE 
INPUT Ol 82eX%, Vy.2 
REM DETERMINE THE MODE FROM THE STATE OF STATUS BIT !@ 


S$="ROLL" 


IF INT(X/2T1Q)-INT(X/2T11)*2>8 THEN 212 


S$="SHEET" 

REM PRINT STATUS 

PRINT "MEDIA MODE IS ";S$ 
END 
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Figure 5-7. GPIB Example Using READ STATUS Command Response. 


REM 

REM SEND IDENTIFY COMMAND 
PRINT @1, 3826" 0" 

REM RETRIEVE RESPONSE 
INPUT @1,S22x, YZ 








REM ROUTINE TO PROCESS IDENTIFY COMMAND RESPONSE 


REM BREAK UP RESPONSE INTO DESIRED DATA AND PRINT 
PRINT "DEVICE NUMBER: “x 
PRINT "“K BYTES OF RAM INSTALLED 
PRINT "FIRMWARE RELEASE NUMBER 
END 


";INTCY/256) 
";Y-INTCY/256) *256 
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Figure 5-8. GPIB Example Using IDENTIFY Command Response. 
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CONTROLLING THE PLOTTER FROM A 
4050 SERIES GRAPHIC SYSTEM 


The following text uses the 4050 Series Graphic 
System to illustrate how a GPIB device is programmed 
to communicate with the Plotter. Three methods are 
shown: one byte at a time, DAB commands, and MSA 
commands. Although the examples are written using 
the 4050 Series BASIC language, most controllers 
have similar capabilities or functions. Refer to the 
programmer’s manual for the specific GPIB device to 
determine how to implement these same functions. 
Refer to the following 4050 Series manuals: 


@ 4050 Series Graphic Computing System Operator's 
Manual 


@ PLOT 50 Introduction to Programming in BASIC 
@ 4050 Series Graphic System Reference Manual 


In the following examples, the Plotter’s device address 
is asssumed to be 1. 


Plotter Communication One Byte at a Time 


The following shows how a 4050 Series RByte or 
WByte statement can be used to command Move, Print, 
and Digitize operations by programming the communi- 
cation one byte at a time. Although these functions, 
which transfer single bytes over the GPIB, are seldom 
used to control the Plotter from 4050 Series Control- 
lers, they do serve to illustrate the GPIB actions 
required to communicate with the Plotter. Almost all 
GPIB devices have this capability and this approach to 
communication can almost always be used. 


Figure 5-9 illustrates a program that sends commands 
in data byte (DAB) form to move the pen to 50,50, print 
an “A”, and then digitize the pen position. 
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The two digit numbers in the WByte statement are the 
ASCII decimal equivalents (ADE’s) of DABs to be 
transmitted over the GPIB. The ADE value for each DAB 
character was shown previously in Figure 5-3. The “@” 
character causes the GPIB’s ATN bus message to be 
sent, and the ‘“:” character causes the ATN message to 
be removed. For example, “WByte @35:” causes the 
MLA 1 bus message to be sent, which enables the 
Plotter (at Device Address 1) to be a listener. 


NOTE 


When the 4050 Series Graphic System issues a 
RByte or WByte statement, it automatically as- 
Signs itself as a listener or talker as required even 
though it is not explicitly enabled in the 
command. 


While the Plotter is enabled as a listener, the MOVE, 
PRINT, and DIGITIZE commands are transmitted. The 
Plotter assumes Command/Response Format 1, so the 
PRINT command is terminated with an =x character. 
The negative value used to express the DIGITIZE 
command causes the EOI bus message to be sent with 
the “G” character to indicate end-of-transmission to 
the Plotter. This also terminates the DIGITIZE command 
and causes its execution. After the bus is cleared by 
the UNL message, the Plotter is enabled as a talker so 
it can transmit the digitize response. As the number of 
characters of the response is not predefined, the 
program reads response bytes until the Plotter sends 
the EOI message along with the last byte of the 
response (the EOI message is detected when the sign 
of X is minus). The desired coordinates are then 
extracted from the string of response bytes and 
printed. 
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REM PLOTTER COMMUNUCATIONS EXAMPLE USING RBYTE AND WBYTE 
118 REM 

{28 REM ISSUE IFC BUS MESSAGE TO RESET THE INTERFACES 
132 INIT 

142 REM SEND DEVICE CLEAR COMMAND TO INITIALIZE PLOTTER 
150 WBYTE @2@: 

160 REM INITIALIZE VARIABLES 

178 A=5 

182 B=50 

198 CS="A" 

200 REM ADDRESS PLOTTER AS A LISTENER 

218 WBYTE @33: 

228 REM SEND MOVE 5@,5@ COMMAND 

238 REM ASSEMBLE THE COMMAND AS A STRING 

248 AS=STR(A) 

250 SS="M"&AS 

260 S$=S$&"," 

270 AS=STR(B) 

280 S$=S$8&AS 

298 REM GO SEND THE STRING 

300 GOSUB 518 

31@ REM SEND PRINT A COMMAND 

320 REM ASSEMBLE THE COMMAND AS A STRING 

338 S$="P"&C$ 

348 S$=S$&"C" 

35@ REM GO SEND THE STRING 

362 GOSUB 514 

370 REM SEND DIGITIZE COMMAND AND THE EOI MESSAGE 
382 WBYTE -71 

398 REM DISABLE THE BUS LISTENERS AND TALKERS 

408 WBYTE @63,95: 

418 REM ADDRESS PLOTTER AS A TALKER 

420 WBYTE @65: 

43@ REM READ THE DIGITIZED RESPONSE AS A STRING 
440 GOSUB 582 

45@ REM DETERMINE COORDINATES FROM STRING AND PRINT 
462 PRINT VAL(S$); 

47@ I=POS(S$,",",@) 

480 S$=REP("" 1,1) 

490 PRINT VAL(S$) 

580 END 

51@ REM ROUTINE TC SEND A STRING 

520 I=LEN(SS$) 

53@ FOR J=1 TO I 

540 AS=SEG(S$,J,1) 

558 WBYTE ASC(AS) 

56@ NEXT J 

570 RETURN 

58@ REM ROUTINE TO READ A STRING 

598 REM 

688 S$="" 

618 RBYTE X 

620 AS=CHR(ABS(X)? 

630 S$=SS&AS 

IF X=>@ THEN 619 

RETURN 


Figure 5-9. GPIB Communications Example Using RByte and WByte to Send DAB Commands. 
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Plotter Communications Using DAB 
Commands 


The following illustrates how higher level 4050 Series 
Basic commands control the Plotter more easily than 
with the RByte and WByte functions. The commands 
used in this section are in DAB form, which you can 
generate through most GPIB devices. 


Figure 5-10 shows the same program as shown in 
Figure 5-9, except the PRINT command is used instead 
of RByte and WByte functions to send the commands. 
The ‘‘@1” characters in the statements direct the 
commands to GPIB Device 1 (the Plotter). The “32” 
entry tells the 4050 Series Graphic System not to use 
the MSA command form (described under the following 
heading). The Print statement automatically causes 
Device 1 (the Plotter) to be addressed as a listener 
before the data bytes are transmitted and the GPIB is 
cleared with the UNT and UNL messages after the 


REM 
INIT 


WBYTE @2Q: 

REM INITIALIZE VARIABLES 
A=5@ 

B=50 

C$="A" 

REM SEND MOVE 58,5@ COMMAND 
PRINT @1,32: "M"sAeB 

REM SEND PRINT A COMMAND 
PRINT @1 532: "PP" 038 

REM SEND DIGITIZE COMMAND 
PRINT @1,32:"G" 





REM READ THE DIGITIZED RESPONSE 


TNPUT Of S22, YZ 

REM PRINT THE COORDINATES 
PRINT XY 

END 
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bytes are transmitted. The “;” character (after the Print 
statement) suppresses a ©r character, which is other- 
wise always added to the bytes transmitted. The input 
command causes the Plotter to be addressed as a 
talker. 


The semicolon used in place of a comma as an 
argument delimiter suppresses formatting spaces, 
which are otherwise automatically added between 
output variables (resulting in less efficient transmis- 
sion to the Plotter). 


Plotter commands can be expressed in BASIC lan- 
guage statements of many different forms. The 
following are all equivalent forms of the MOVE 50,50 
command from Figure 5-10: 


PRINT @1,32: “M50,50” 
or 

C$="M505p50” 

PRINT @1,32:C$ 


REM PLOTTER COMMUNICATIONS EXAMPLE USING DAB COMMANDS 





REM ISSUE IFG BUS MESSAGE TO RESET THE INTERFACES 


REM SEND DEVICE CLEAR COMMAND TO INITIALIZE PLOTTER 


Figure 5-10. GPIB Communications Example Using PRINT to Send DAB Commands. 
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If the command is expressed as a String constant or 
string variable, the characters between the quote 
marks are transmitted to the Plotter as specified. In the 
first form, a comma is the argument separator. In the 
second form, a space is the argument separator. The 
command is terminated by the GPIB EOI message sent 
at the end of the PRINT command. 


PRINT @1,32:'M’;50;50 
or 

A=50 

B=50 

PRINT @1,32:"M”;A;B 
or 

A=50 

B=50 

C$=""M” 

PRINT @1,32:C$;A;B 


In these forms, the command code is expessed as a 
string constant or string variable. Arguments are nu- 
meric constants or numeric variables. The semicolon 
character suppresses formating spaces, which would 
otherwise be automatically inserted by the 4050 Series 
Graphic System before the numbers (resulting in extra 
characters to transmit). When a numeric value is 
transmitted, it is automatically preceded by a space 
character unless the value follows a string value. Thus, 
the command actually transmitted in all three cases is: 


M505?50 


where the space is the argument separator. In the 
following command expression, the numeric variable B 
follows the string value C$, which causes the automat- 
ic space character to be suppressed: 


B=50 
C$="M505e" 
PRINT @1,32:C$;B 


Thus, the space used as the argument separator must 
be included in the string value. 


In the following command expression, a string constant 
follows a numeric constant: 


B=50 


C$="5p50” 
PRINT @1,32:M”;B;C$ 
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Again, the transmitted command in all three cases is: 
M505P50 


Here, the space is also used as the argument separator 
and must be included in the string value. 


NOTE 


The comma or semicolon characters appearing 
as delimiters in BASIC program statements (and 
not within string definitions) are not transmitted 
to the Plotter. The argument separators and 
command terminators required for Plotter com- 
mands MUST be specified in addition to the 
delimiters required in the BASIC program 
statements. 


Multiple Plotter commands can be combined on the 
same line, as shown in the following examples using 
the MOVE 50,50 and the PRINT A commands from 
Figure 5-10: 


PRINT @1 ,32:°M”3A;B;“P”:CS$ 
or 
PRINT @1,32:“M505p50PA” 


These are only two of the several possible expressions 
of these commands. If the DIGITIZE command is 
combined with the previous two, the print string would 
have to be terminated with an =x character as shown 
below (the previous example shows the EO! bus 
message terminating the print string argument and the 
command line): 


PRINT @1,32:"M505pP50PAExG” 
For clarity, these commands could be separated by a 
command terminator character, as shown next: 
PRINT @1,32:‘'M505p50;PAEx:G” 


NOTE 


The single letter Plotter commands A or C (or D if 
NULL arguments are used) should always be 
followed by a command terminator to ensure 
correct interpretation of the commands if another 
command follows on the same line. 
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Plotter Communications Using MSA NOTE 


al Commands This optional use of the GPIB MSA messages 
does not conform to the IEEE Standard 488-1978 
definition of MSA messages. However, it does 
provide a convenient way of writing programs 
using functions common to both the Plotter and 
the display portion of the 4050 Series controllers. 
You can direct output to either the Plotter or the 


Figure 5-11 shows the same example used in the 

previous discussion using the MSA command forms. 
= This example illustrates how 4050 Series BASIC 
statements can be used to generate the MSA form of 
the Plotter commands using the PRINT and INPUT 
Keywords. Refer to the command description sections 


_ or to Table 5-2 to determine if a MSA equivalent form is anes bi! eli I ae Aga ce 
given for the desired Plotter command. ; 
NOTE 
— 


The INPUT statement is not required in this form 
because the GIN statement automatically does an 
Input function. 


REM PLOTTER COMMUNICATIONS EXAMPLE USING MSA COMMANDS 
REM 

REM [ISSUE IFG BUS MESSAGE TIO (RESET THE INTERFACES 
INIT 

REM SEND DEVICE CLEAR COMMAND TO INITIALIZE PLOTTER 
WBYTE @2@: 

REM INITIALIZE VARIABLES 

A=50 

B=52 

C$="A" 

REM SEND MOVE 58,58 COMMAND 

MOVE @1:A,B 

REM SEND PRINT A COMMAND 

PRINT @1:C$; 

REM SEND DIGITIZE COMMAND AND READ THE RESPONSE 

GIN @1:X,Y 

REM PRINT THE DIGITIZED RESPONSE 

PRINT X;Y 

END 





= Figure 5-11. GPIB Communications Example for MSA Command Form. 
— 
= 
- 
nd 
= 
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The Plotter accepts the MSA commands shown in 
Table 5-2 for compatibility with 4050 Series Graphics 
Systems. All MSA commands not listed here are 
ignored. Table 5-2 also indicates any corresponding 
4050 Series BASIC language keywords that are used 
to generate these commands. 














Table 5-2 

MSA COMMANDS 

MSA | Equivalent 4663 Command | Corresponding 
4050 Series 
Keyword 
———— = 
00¢ | READ STATUS a 
07 RESET ALPHA PARAMETERS j 2 
08 PEN CHANGE a 
12 PRINT PRINT 
13¢ | IDENTIFY (SIZE) a 
Ve. SET ALPHA SCALE a 
18 SELECT STANDARD a 
ALPHA FONT 

19 PRINT LIST (TLIST) 
20 DRAW DRAW (RDRAW) 
21 MOVE MOVE (RMOVE) 
22 MOVE TO HOME PAGE 
23 MOVE TO HOME HOME 
24 DIGITIZE GIN 
25 SET ALPHA ROTATION a 
26 PROMPT LIGHT a 
27¢ | CALL DIGITIZE a 
None | None [ AXIS > 








aNo corresponding 4050 Series keyword. 


>The 4050 Series Graphic System sends MOVE and DRAW commands to the 
Plotter to draw the axis. No corresponding MSA command or 4663 AXIS 
command |s generated. 


°The INPUT keyword is used Instead of the PRINT keyword to generate the 
Plotter command for these secondary addresses. 
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a 
All commands listed in Table 5-2 can be generated in 
the MSA form as the commands shown in Figure 5-11 al 
(for example, using the PRINT and INPUT keywords). 
Alternatively, the available keywords listed in Table 5-2 
can be used to generate the commands. For example: 
PRINT @1,20:"50,50” - 
or 
DRAW @1:50,50 
Pty 


Both examples express a Plotter DRAW command. 

However, the 4050 Series Graphic System performs 

additional processing of commands produced with the 

MOVE, RMOVE, DRAW, and RDRAW keywords (which = 
are not done if the commands are generated using the 

PRINT keyword). For example, the Window and 

Viewport established by the 4050 Series Graphic 

System will transform commands (containing MOVE = 
and DRAW keywords) before they are sent to the 
Plotter. To avoid this transformation in the 4050 Series 
Graphic System, set the Graphic System Viewport and 
Window to the same values. (The Viewport and Window 
are automatically set to the same values upon power- 
up or when an INIT statement is executed.) Commands 
generated by 4050 Series BASIC statements that -~ 
contain the MSA or DAB Plotter command forms will 

not be transformed before being sent to the Plotter. 


If Plotter DRAW commands generated by DRAW or wr" a 
RDRAW keywords contain coordinates outside the 

4050 Series Graphic System’s Window, the coordi- 

nates will be “clipped”. Thus, the 4050 Series Graphic 

System’s Window should be set larger than any ” 
coordinates generated by DRAW or RDRAW keywords 


to avoid any “clipped” action. 


Plotter MOVE or RMOVE commands (either generated = 
by MOVE and RMOVE keywords or generated by MOVE 
and DRAW commands expressed in MSA or DAB form) 
are not “clipped” before transmission to the Plotter -_ 
NOTE 
The clipping action of the 4050 Series Graphic 
System may give unexpected results if you too 
generate graphics by commands expressed using 
a combination of Keyword, MSA, and DAB forms. 
Use only MOVE (RMOVE) and DRAW (RDRAW) a 
keywords /f you are using the clipping funtions in 
the 4050 Series Graphic System. 
= 
= 
— 
— 
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INTRODUCTION TO COMMANDS AND ARGUMENTS 


INTRODUCTION 


This section covers the following topics, all related to 
the command description sections (Sections 7 through 
16): 

Conventions and Notations 

Command Description Overview 

Syntax for Serial Interface Applications 

Syntax for GPIB Interface Applications 


Syntax for 4050 BASIC Applications (Using the 
GPIB Interface) 


To begin, the programmer must be familiar with the 
manual conventions and notations presented at the 
beginning of the manual (before Section 1) and also 
following this introduction. 
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The user must also be familiar with the fundamental 
command structure and argument types of one applica- 
tion interface (either Serial, GPIB, or 4050 Series 
BASIC GPIB). For details refer back to either /ntroduc- 
tion to Serial Commands and Responses, or Introduc- 
tion to GPIB Commands and Responses, located in the 
previous two sections. 


Once these prerequisites are achieved, the user can go 
directly to the desired command descriptions (using 
the Command Description Overview and specific 
interface applications described in this section). 
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CONVENTIONS AND NOTATIONS 


The following summarizes the associated conventions 
and notations used throughout this manual. 


CHARACTERS 


ASCII Characters 


The 94 printing ASCII characters (numbers, symbols, 
and uppercase and lowercase letters) are represented 
by their normal symbols. 


The ASCII Control, SPACE, and DELETE characters are 
each represented by an appropriate single symbol. See 
the ASCII Code Chart appendix. 

NOTE 


The ASCII SPACE character is always shown as 
Sp, and not as a blank space between printed 
characters. 

Examples: &12ABab &c 5p? 


The last three ASCII characters are ESCAPE, SPACE, 
and DELETE. 


Special Characters 


Two symbols are replaced by certain single ASCII 
characters. The two symbols, “1 and 4p, represent the 
attention and address characters, respectively, and are 
replaced as follows: 


@ “7 — attention character, replaceable by 
Ect A ory 

@ “p — address character, replaceable by 
ABCDEFGorH 
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Boldface Type 


A literal element, which is entered exactly as shown, is 
shown in bold. 


Regular Type 


A variable element, which is replaced by appropriate 
specific information, is shown in regular type; a single 
element can be represented by one symbol, one word, 
or words connected by hyphens. 


Examples 


Ar Ap R rotation-angle 


where three elements are replaced and R is entered 
exactly as shown. 


!AR45 


where five ASCII characters are entered exactly as 
shown. 
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COMMAND ELEMENTS 


Element Types 


The last words of a 4663 Plotter variable element name 
indicates the element type required by the 4663, as 
shown below: 


Last Words Element Type 
selector selector 

string string 
print-string print string 

pa primary address 


target-variable target variable 
Other endings imply a numeric element. 
Examples: 

@ axis-selector is a selector element 

®@ print-character-string is a string element 


@ radius is a numeric element 


Omitted Numeric Elements 


When a numeric element is omitted, a value of zero is 
assumed. Any exceptions are noted where they occur. 


Argument Separators 


A nonbold comma (,) between elements can be re- 
placed by either a bold comma (,) or one or more Sp 
characters. A nonbold semicolon (;) between variable 
elements can be replaced by either a bold semicolon 
(;) or a bold comma (,). Exceptions are noted where 
they apply. 


Command Terminators 


Command terminators are generally NOT shown in the 
individual command descriptions. Specific termination 
varies with the interface and the Command/Response 

Format used. Refer to Sections 4 and 5 for instructions 
on how to terminate commands. 
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NOTATIONS 


Brackets[ ] 


An element inside brackets is optional. Stacked ele- 
ments within brackets indicate selection of one or none 
of the elements. 


Example: [0] select O, 1, or neither 


[1] 
Braces { } 


When multiple elements are stacked within braces, one 
element must be selected. 


Example: {0} 
{1} select 0,1, or 2 
{2} 

Dots... 


Three dots (ellipsis) indicate that a previous element 
may be repeated. 


Example: Sp... one or more Sp characters 


Indented for Continuation 
lf a command is continued on to the next printed line, 
the additional line is indented. 


At Ap X x-value,y-valuel,x-value, 
y-value] ... 


Example: 
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COMMAND DESCRIPTION OVERVIEW 


Each command section is divided into two parts: 
general concepts and specific command descriptions. 
Each command description follows a general format 
and is comprised of all or some of the following: 

@ Purpose 


@ Syntax Boxes 
There are up to three applications: 


e Serial 
e GPIB 
e 4050 BASIC 
® For 4050 BASIC, there are up to three forms: 
e Data Byte Form 
® Secondary Address Form 
e Special Keyword Form 


@ Parameters 
Includes restrictions, meanings assigned to selector 
arguments, etc. 


® Outputs 
@ Comments 


@ Errors 
Includes error messages, causes of errors, and 
Plotter responses. 


@ Examples 


For each of the interface applications, the syntax boxes 
show a a recommended general command form that 
can be used under most conditions. All syntax boxes 
(with the exception of the general GPIB form) include 
specific examples of the commands. The contents of 
the syntax boxes and related considerations are dis- 
cussed separately for each of the following interface 
applications: Serial Interface, GPIB Interface, and 4050 
Series BASIC GPIB. 


SYNTAX FOR SERIAL INTERFACE APPLICATIONS 


Plotter commands are transmitted via the Serial inter- 
face as a series of ASCII characters. The general 
syntax form and sample are shown for each Style | 
command in the first syntax box for each command 
description. (Refer to Section 4 for Style I! command 
information.) 


Refer to Figure 6-1. Each Style | command consists of 
an attention character, an address character, a one- or 
two-character command code and, for many com- 
mands, one or more arguments and argument 
separators. For Command/Response Formats 1 or 2 
only, the command may include an optional command 
termination character (either ©r or ;). Unless otherwise 
noted, the information in a Serial syntax box applies for 
Command/Response Formats 1-4. 
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NOTE 


Some commands request information from the 
Plotter. In these cases, the syntax box contains 
either One Output Message Block Produced or 
Two Output Message Blocks Produced; for the 
READ MACRO STATUS Command the syntax box 
contains the statement One Output Message 
Block Per Macro. For these commands, additional 
contro! procedures are involved. 
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Pa 


a5 8 oe 
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ATTENTION CHARACTER 


This character is to be replaced by the attention 
character selected on the Parameter Entry Card. The 
choices are: £c, !, A, or Sy. 


ADDRESS CHARACTER 


This character is to be replaced by the address 
character selected on the Parameter Entry Card. The 
choices are A, B, C, D, E, F, G, or H. 


COMMAND CODE 


The command code consists of one or two characters. 


Letter characters may be either uppercase or lower- 
case. 


ARGUMENTS 


Argument names identify the argument and the argu- 
ment type. See /ntroduction To Serial Commands And 
Responses in Section 4. 


ATTENTION CHARACTER 


ADDRESS CHARACTER 


COMMAND CODE 
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INTRODUCTION TO COMMANDS AND ARGUMENTS 


ARGUMENT SEPARATORS 


Each nonbold comma (,) shown as an argument 
separator is replaced by a bold comma (,) or by one or 
more Sp characters. Any exceptions are noted where 
they apply. 


COMMAND TERMINATION 


Command termination occurs either when the next 
command’s attention character is received; in Com- 
mand/Response Formats 3 or 4 only, termination 
occurs immediately for commands without arguments. 
For Command/Response Formats 1 and 2, an optional 
command terminator character (either ©r or ;) may be 
used to terminate commands. 


SAMPLE 


The syntax sample shows one valid command of the 
general form presented, where the attention character 
is °c and the address character is A. 


ARGUMENTS AND ARGUMENT SEPARATORS 


x-value,y-valuel,x-value,y-value] ... 
1000,2000 


Figure 6-1. A Typical Command Form and Sample for the Serial Interface. 
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INTRODUCTION TO COMMANDS AND ARGUMENTS 


SYNTAX FOR GPIB INTERFACE APPLICATIONS 


NOTE 


If you are using 4050 Series BASIC GPIB, skip to 
the Syntax for 4050 Series BASIC GPIB Applica- 
tions heading. 


Plotter commands are transmitted over the GPIB bus 
as a series of ASCII characters, accompanied by 
control information. One or more commands may be 
included in one GPIB transmission. The general 
command form in the second syntax box shows the 
command code and arguments only. See Figure 6-2. 
Associated control information for GPIB communica- 
tion is not shown. (Refer to the GPIB Interface section 
for more information.) Unless otherwise noted, the 
general form and sample applies for Command/ 
Response Formats 1 through 6. 


NOTE 


Some commands request information from the 
Plotter. In these cases, the syntax box contains 
either One Output Message Block Produced, or 
Two Output Message Blocks Produced; for the 
READ STATUS MACRO command, the syntax box 
contains the statement One Output Message 
Block Per Macro. For these commands, additional 
control procedures are involved (see the GPIB 
Interface section, Section 5). 


COMMAND CODE 


The command code consists of one or two characters. 


Letter characters may be either uppercase or lower- 
case. 


COMMAND CODE 


NOTE 


For some commands, a GPIB Secondary Address 
may be transmitted instead of the command 
code. For these commands the 4050 BASIC 
Secondary Address form shows which secondary 
address is assigned for the command. 


ARGUMENTS 


Argument names identify the argument and the argu- 
ment type. See /ntroduction To GPIB Commands And 
Responses in Section 5 for argument type 
explanations. 


ARGUMENT SEPARATORS 


Each nonbold comma (,) shown as an argument 
separator is replaced by a bold comma (,) or by one or 
more Sp characters. Specific exceptions are noted 
where they apply. 


COMMAND TERMINATION (NOT SHOWN) 


A command may be terminated by a semicolon (;) 
termination character (if several commands are sent at 
once). For Command/Response Formats 5 and 6, the 
command is automatically terminated at the end of a 
GPIB transmission. For specific details on how to 
terminate commands, refer to Section 5. 


ARGUMENTS AND ARGUMENT SEPARATORS 


x-value,y-value[,x-value,y-value] ... 





Figure 6-2. A Typical Command Form for GPIB. 
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INTRODUCTION TO COMMANDS AND ARGUMENTS 


SYNTAX FOR 4050 SERIES BASIC GPIB APPLICATIONS 


In the third syntax box for each command description, 
up to three forms of 4050 BASIC statements are 
available for each command. Each general form illu- 
strates one way to generate a correct Plotter command. 
(No attempt is made to show all possible ways of 
generating Plotter arguments using BASIC.) Unless 
otherwise noted, information applies for Command/ 
Response Formats 1 through 6. Refer to Figure 6-3. 


PRIMARY ADDRESS AND 
SECONDARY ADDRESS 


As shown in Figure 6-3, all three forms require a GPIB 
primary address value that matches the selection made 
on the GPIB device address line of the Parameter Entry 
card. One form requires the specific GPIB secondary 
address value assigned to a specific command. A 
primary address or secondary address value may be 
represented within a BASIC statement by any valid 
BASIC numerical expression. For example, a primary 
address of one may be represented by 1 or by D where 
D=1. 


COMMAND CODE 


Each command requires either a command code (one 
or two characters) or the equivalent secondary address 
assigned to that command. 


ARGUMENTS AND ARGUMENT 
SEPARATORS 


For Plotter commands that can have arguments, all 
three forms show how to generate Plotter arguments 
and separators within a BASIC statement. Each Plotter 
selector or numeric argument may be generated by a 
corresponding BASIC numeric expression; the BASIC 
statement produces the corresponding Plotter argu- 
ment (and argument separators as needed). Also, one 
or more Plotter arguments (and argument separators) 
may be generated by a BASIC string variable or string 
constant if care is taken to include each required 
Plotter argument separator. 
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NOTE 


Whenever a BASIC string-constant or string- 
variable used for the first of two Plotter numeric 
arguments is followed by a semicolon (;) and a 
numeric expression, the automatic §p before the 
second argument is suppressed. The Plotter 
requires a separator; for example, either a Sp or a 
comma (,). Programming actions that avoid the 
problem are: 


®@ Use acomma (,) instead of a semicolon (;) 
between the string constant or string variable and 
the following numeric expression. 


@ Include a Plotter Argument Separator character 
(such as a comma) as the last character of the 
BASIC string-constant or string-variable. 


You must use a comma (,) instead of a semicolon (;) 
between the string-constant or string-variable and 
the following argument if the following argument is a 
4050 BASIC array variable. 


For commands that require a print-string argument, the 
BASIC statement can contain a string-constant, string- 
variable, numeric expression, or a combination of all 
three. The Plotter prints the actual character string that 
the BASIC statement produces. 


NOTE 


Do not forget to include the print string termina- 
tion character (x) whenever a print string is 
followed by another command in the same BASIC 
statement. Remember that a semicolon (;) at the 
end of the statement suppresses the automatic Cr 
produced at the end of a BASIC print statement. 


For commands that require a string argument, you must 
either: 


@ Produce a delimited string that begins and ends with 
the proper delimiter character (quotation mark or 
apostrophe). 


@ Produce an undelimited string that begins witha 
valid character (such as an uppercase or lowercase 
letter) and ends with a proper terminator (the =x 
termination character is required for most 
applications). 
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INTRODUCTION TO COMMANDS AND ARGUMENTS 


PRIMARY ADDRESS 


SECONDARY ADDRESS 


COMMAND CODE 


ARGUMENTS AND ARGUMENT SEPARATORS 


x-value;y-value[;x-value;y-value] ... 


x-value,y-value 


x-relative-value,y-relative-value 


Figure 6-3. The Three Command Forms for 4050 BASIC Applications. 
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Section 7 


SERIAL INTERFACE COMMANDS 


INTRODUCTION 
Serial interface commands control the communication the Plotter. Before using these commands, please read 
between a user’s host computer or other devices and Section 4 of this manual. 


COMMAND DESCRIPTIONS 


Because these commands deal only with Serial inter- @ SET BLOCK SIZE 

face operation, the GPIB and 4050 Series GPIB syntax © SET BYPASS CANCEL CHARACTER 

boxes are not included for the command descriptions. 

There are twelve commands described in this section. @ SET SIGNATURE CHARACTER 

These are: @ SET PROMPT STRING 

@ DEVICE ON e@ INTERFACE PARAMETER RESET 

@ DEVICE OFF @ DATA RESET 

@ BLOCK START @ SELECT COMMAND/RESPONSE FORMAT 

@ BLOCK END Each command is described separately in the para- 
@ SET TURNAROUND DELAY graphs that follow. 
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SERIAL INTERFACE COMMANDS 


DEVICE ON 


Purpose: This command turns the Plotter to the logical on state. 


SERIAL 





Ay Ap E 


Sample: FcAE 


Comments 


After a DEVICE ON command, the Plotter is in the 
logical on state and will interpret all characters re- 
ceived as commands. The AUTO MUTE function is 
enabled if it has been chosen on the Parameter Entry 
Card. This means that in a loop-thru configuration, 
received characters beginning with the command 
character E will not be sent to the terminal. This 
condition remains in effect until a DEVICE OFF com- 
mand is received. 


A BLOCK START command also turns the Plotter to the 
logical on state. 
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NOTE 


At power-up or after a front panel Initialize is 
done, the Plotter is in the logical off state. An 
exception to this rule occurs if an Initial Com- 
mand/Response Format of 3 or 4 is used and an 
Initial Aspect Ratio of 4X:3Y is selected on the 
Parameter Entry Card. Then the Plotter will be 
logically on at power-up or after a front panel 
Initialize. This is emulation of the TEKTRONIX 
4662's Copy Mode feature. A DEVICE OFF com- 
mand may be used in this mode to turn the Plotter 
to the logical off state. 
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DEVICE OFF 


SERIAL INTERFACE COMMANDS 


Purpose: This command turns the Plotter to the logical off state. 


SERIAL 
At Ap F 
Ec AF 


Sample: 


Comments 


After a DEVICE OFF command, the Plotter is in the 
logical off state and all received characters are not 
interpreted as commands (until either a DEVICE ON or 
BLOCK START command is recognized). The AUTO 
MUTE selection on the Parameter Entry Card is 
disabled. The terminal then receives all characters sent 
by the host computer. 


With AUTO MUTE selected at higher communication 
rates (more than 1200 baud), a few characters 
immediately following a DEVICE OFF command may be 
garbled when received by a loop-thru terminal. Refer to 
Section 4 for more information. 
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The Plotter is logically off at power-up or after a front 
panel Initialize, except as noted in the comments under 
the DEVICE ON command. 


NOTE 


In Command/Response Formats 1 and 2, the 
DEVICE OFF command will not be processed until 
a terminator character is received. 
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SERIAL INTERFACE COMMANDS 


BLOCK START 


Purpose: This command is used to begin a block in Block Mode communications, and also turns the Plotter to the 
logical on state (this action is equivalent to a DEVICE ON command). 


SERIAL 


Ar Ap ( 


Sample:  cA( 


Comments References 
A BLOCK START command initiates Block Mode A complete description of Block Mode communications 
communication. The Serial interface starts a checksum is given in Section 4 of this manual. 


calculation beginning with the “(’’ command code 
character and ending with the “)‘ character of the 
BLOCK END command. 
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SERIAL INTERFACE COMMANDS 





_ 
wy 
BLOCK END 
Purpose: This command ends a block in Block Mode communications. The Plotter sends an A (or an I) indicating 
he that the block has been received correctly (or incorrectly) and that the Plotter is ready to accept another block of 
data. 
SERIAL 
st 
Ar Ap) checksum-value 
Sample: cA) 373 
a 
be Parameters References 
checksum-value See Section 4 for complete information on Block Mode 
Block checksum value, 0-4095. Special value: 0 communication. 
in means no checksum verification, positive block 
acknowledge response generated 
Errors 
Outputs Error 9 
= (Block Checksum Error) 
one character (plus signature character and output 
termination character(s) as selected) Error 44 
PW siBlock acknowledge responses, A or I: (Integer Outside Legal Range) Values greater than 
- @ A= positive block acknowledge (block is accept- 4095 result in rejection of the block; negative values 
ed, ready for next block) are taken as zero (block is accepted). 
@ |= negative block acknowledge (block is reject- 
= ed, retransmit last block) 
Comments 
et 
The checksum is the sum of the ASCII! decimal 
equivalent (ADE) values of the characters contained in 
the block. The sum begins with the ‘“(” character of the 
aad BLOCK START command and ends with the “)” 
character of the BLOCK END command. The rules for 
calculation of checksums are presented in Section 4. 
-) 
- 
-” 
oe 
— 
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SERIAL INTERFACE COMMANDS 


SET TURNAROUND DELAY 


Purpose: This command sets the turnaround delay time. 


SERIAL 
AT AD G 


ECAG 


Sample: 


Parameters 


delay-time 
Delay time, in milliseconds, 0-65535. Resolution is 
approximately 8 ms. 


Comments 


Some host computers cannot accept input from a 
device immediately after sending information to it. A 
time delay called the turnaround delay must occur or 
data is lost. This command forces the Plotter to wait the 
requested time delay before transmitting to the host 
computer. The same delay time is also used between 
Plotter output messages. 


The default value for the delay-time is zero. This is the 


value at either power-up or after an INTERFACE 
PARAMETER RESET command is received. 
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delay-time 
200 





References 


See Communication With Other Devices in Section 4 
for a complete discussion of Plotter to host communi- 
cation. 


Errors 


Error 44 
(Integer Outside Legal Range) Values less than zero 
are taken as zero; values greater than 65535 are 
taken as 65535. 
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SET BLOCK SIZE 


SERIAL INTERFACE COMMANDS 


Purpose: This command sets the maximum size of blocks that will be sent during Block Mode communications. 


SERIAL 





AT AyD H 


Ec AH 


Sample: 


Parameters 


maximum-block-size 
Maximum number of characters that will be sentina 
block, 0-65535. 


Comments 


The maximum-block-size value should include room for 
the BLOCK START and BLOCK END commands 
(including checksum and terminator characters). 


The default value for block size is zero. This is the 
value at power-up or after the INTERFACE PARAME- 
TER RESET command is received. 
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maximum-block-size 
132 


References 

See Section 4 for a discussion of Block Mode commu- 
nications and recommendations for block size values. 
Errors 


Error 8 
(Block Size Exceeds Input Buffer Size) 
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SERIAL INTERFACE COMMANDS 


SET BYPASS CANCEL CHARACTER 


Purpose: This command sets the bypass cancel character. 


SERIAL 
Ar ApU 


Sample: fcAU 


Parameters 


bypass-cancel-character-string 
Represents the single character to be used as the 
bypass cancel character. An omitted argument or 
the character Nu (ADE 0) disables this function. 


Comments 


Output messages from the Plotter may be echoed 
(returned to the Plotter) by the host computer. When 
the correct bypass cancel character is selected, the 
Plotter ignores the host computer echo. 


The bypass cancel character selected should be the 


last character echoed from a Plotter output message. 


For example, when the Plotter output terminator is ©r 
(selected on the Parameter Entry Card), and the host 
computer echoes ©r with ©r +s, the bypass cancel 
character should be set to ‘r. 


The default value for the bypass cancel character is Nu. 


This is the value at power-up or after an INTERFACE 
PARAMETER RESET command is received. 
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bypass-cancel-character-string 


Le 





References 

See Section 4 for a description of string argument 
forms. 

Errors 


Error 45 
(Too Many Entries or String Too Long) The first 
character becomes the bypass cancel character. 


Examples 


The sample shown in the syntax box sets the bypass 
cancel character to 'r. 
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SERIAL INTERFACE COMMANDS 





_ 
SET SIGNATURE CHARACTER 
wat 
Purpose: This command sets the signature character that the Plotter prefixes to each output block. 
™ SERIAL 
AT ADS signature-character-string 
- Sample: cAS a 
| 
Parameters References 
signature-character-string See Section 4 for a description of string arguments. 
| Represents the single character to be used as the 
signature character. An omitted argument or the Errors 
character Nu (ADE 0) disables this function. 
a Error 45 
Comments (Too Many Entries or String Too Long) The first 


character becomes the signature character. 
This command causes output blocks from the Plotter to 
= be prefixed with the specified signature character. This 
character can be used to identify the specific Plotter 
originating an output message when more than one 
plotter is used in the same loop-thru configuration. 


The default (power-up) value of the signature character 
is Ny (no signature character). The INTERFACE PAR- 
AMETER RESET command also resets the signature 
character to Nu. 
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SERIAL INTERFACE COMMANDS 


SET PROMPT STRING 


Purpose: This command sets the prompt character string, which the Plotter must receive before any output 


message is sent to the host computer. 


SERIAL 
ATADR 


ECAR 


Sample: 


Parameters 


prompt-character-string 
Represents the prompt character string, 0-4 
characters; omitted argument or Nu turns off Prompt 
Mode. 


Comments 


Some host computers can accept input from a device, 
such as a terminal or Plotter, only at certain times. A 
prompt string (e.g., “?”) is sent to a device to indicate 
input is expected (and will be accepted). The SET 
PROMPT STRING command causes the Plotter not to 
transmit output messages to the host computer until 
the specified prompt string is received. A prompt string 
must be received for each output message. 


The default value of the prompt-string is Nu. This is the 
value at power-up or after the INTERFACE PARAME- 
TER RESET command is received. A prompt-string of 
Ny indicates that Prompt Mode output protocol is not 
enabled. 


7-10 


prompt-character-string 


“Sp” 





References 

See Section 4 for a complete description of Prompt 
Mode and string argument forms. 

Errors 


Error 45 
(Too Many Entries or String Too Long) The first four 
characters are used. 
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INTERFACE PARAMETER RESET 


SERIAL INTERFACE COMMANDS 


Purpose: This command resets interface parameters to default (power-up) values. 


SERIAL 





At AD CR 
EC ACR 


Sample: 


Comments 


This command resets the following interface parame- 
ters to default values: 


Block Size to Oo 
Turnaround Delay to oO 
Bypass Cancel Character to ‘u 
Signature Character 
Prompt String to Nu 


Additional effects of this command are: 


@ The Command/Response Format is reset to the 
value selected on the Parameter Entry Card. 


®@ The type of Device Units is reset to ADUs (Address- 
able Device Units). 
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@ The Point light is turned off and blinking is stopped. 
The light will be on steadily in Command/Response 
Formats 3 and 4. 


@ The Operator Digitize enable state, if enabled by the 
OPERATOR DIGITIZE command, is canceled. No last 
output block is sent by the Plotter. For 
Command/Response Formats 3 and 4, the perman- 
ently enabled Digitize state is entered. 


References 


See Section 13 for more information. 


SERIAL INTERFACE COMMANDS 


DATA RESET 


Purpose: This command deletes commands from the input buffer that have not been executed. Later commands 
are not affected. 


SERIAL 





Ar An CD 


Sample: fc ACD 


Comments 


This command should be used carefully. Any com- 
mands that have already been read from the interface 
input buffer (and are being processed by the Plotter) 
will be executed. Other stored commands are deleted. 
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SERIAL INTERFACE COMMANDS 


SELECT COMMAND/RESPONSE FORMAT 


Purpose: This command selects a Command/Response Format, overriding the selection made on the Initial 
Command/Response Format line of the Parameter Entry Card. 


SERIAL 





At Ap CC format-selector 


Sample: Fe ACC 2 


Parameters @ The Point (Prompt) light is turned off, except in 
Command/Response Formats 3 and 4, when the 
format-selector Point light is on steadily. The Plotter stops scanning 
Command/Response Format, 1-4 for the prompt string (if one is defined). 
@ The Operator Digitize enable state (if enabled by the 
Comments OPERATOR DIGITIZE command) is canceled. No 
last output block is sent by the Plotter. In Com- 
The Command/Response Format determines the argu- mand/Response Formats 3 and 4, the Plotter enters 
ment and command terminator syntax expected for the permanently enabled Digitize state. See Section 
input commands and the type and form of output 13 for more information. 
messages that can be generated. 
_ These additional effects result from this command: References 
@ The type of Device Units is reset to ADUs. See Setting Up the Parameter Entry Card in Section 4 
for a complete description of Command/Response 
NOTE Formats. 


If the SET WINDOW command is used when the 
current Device Units are not ADUs, this command 
changes the Window’s numerical range. To 
restore the Window to the desired values, either 
reselect the type of Device Units type used with 
the original SET WINDOW command or redefine 
the window using the SET WINDOW command. 
See Section 11 for more information. 
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Section 8 


GPIB INTERFACE COMMANDS 


INTRODUCTION 


GPIB interface commands affect the form and type of 

communication between the Plotter and the controller 
(such as the TEKTRONIX 4050 Series Graphics Com- 
puting Systems). 


Definition of GPIB characteristics includes certain 
signals and commands that are recognized by the 
Plotter. These include the Interface Clear signal and 
four GPIB commands: DEVICE CLEAR, SELECTED 


DEVICE CLEAR, SERIAL POLL ENABLE, and DISABLE. 


The use of these commands is different from the Plotter 
commands presented in this section. Usually, the 
controller has a keyword command that generates 
these signals or commands. The controller's manual 
should be consulted for what commands are available 
and how to use them. The GPIB Interface section of 
this manual, Section 5, describes the functions sup- 
ported by the Plotter. 


COMMAND DESCRIPTIONS 


There are three commands described in this section: 


@ DATA RESET 
@ SELECT COMMAND/RESPONSE FORMAT 
@ INTERFACE PARAMETER RESET 


The following pages describe each command 
separately. 
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Because the commands in this section deal only with 
GPIB interface operation, the Serial syntax box is not 
included for these command descriptions. 
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GPIB INTERFACE COMMANDS 


DATA RESET 


Purpose: This command deletes previous commands sent to the Plotter that have not yet been processed. 


Subsequent commands are not affected. 


GPIB 
cD 


» 4050 BASIC (Data Byte Form) c2=== 
PRINT @pa,32: “CD” 





Sample: PRINT @1,32: “CD” 


Comments 


This command should be used carefully. Any com- 
mands that have already been read from the interface 
input buffer (and are being processed by the Plotter) 


will be executed. Other stored commands are deleted. 
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GPIB INTERFACE COMMANDS 


SELECT COMMAND/RESPONSE FORMAT 


Purpose: This command selects a Command/Response Format, overriding the selection made on the Initia! 
Command/Response Format line of the Parameter Entry Card. 


GPIB 





g= 4050 BASIC (Data Byte Farry) cesses nce rarer 
PRINT @pa,32: “CC”; 


Sample: PRINT @1,32: “CC”; 
IOS SOS PE ee PS. 6 Ee a eS ee 
Parameters 


format-selector 
Command/Response Format selector, 1-7 


Comments 


The Command/Response Format determines the type 
of command and argument syntax expected, as well as 
the form and nature of output messages. 


This command performs these additional actions: 


@ The type of Device Units is set to GDUs (Graphic 
Device Units). 


@ The Operator Digitize enable state, if enabled by the 
OPERATOR DIGITIZE command, is canceled. No last 
output block is sent by the Plotter. For GPIB 
Command/Response Formats 5 and 6, the 
permanently enabled Digitize state is entered. See 
Section 13 for more information. 


@ The Point light is turned off, except in Com- 
mand/Response Formats 5 and 6 when it is on 
steadily. 
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format-selector 
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format-selector 


| 
Pray 


i 
Visors 


The following is a brief description of the available 
GPIB Command/Response Formats: 


@ Formats 1, 3, and 5 are compatible with the 
TEKTRONIX 4050 Series desk-top computing sys- 
tems. Formats 2, 4, and 6 are compatible with 
Hewlett-Packard desk-top calculators, such as the 
HP 9845. 


@ Formats 5 and 6 are compatible with the TEKTRON- 
IX 4662 Plotter. However, there are some 
differences that are noted in Section 5. 


®@ Format 7 is a special format that accepts Serial 
interface commands but does not allow any output 
to be generated. 


References 


A complete description of GPIB Command/Response 
Formats is given in the Section 5. 
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GPIB INTERFACE COMMANDS 


INTERFACE PARAMETER RESET 


Purpose: This command resets both the GPIB dependent parameters and states to the default (power-up) values. 


GPIB 
CR 


»4050 BASIC (Data Byte Form) 


PRINT @pa,32: “CR” 
Sample: PRINT @1,32: “CR” 


Comments 
This command performs the following actions: 


@ The Command/Response Format is reset to the 
value selected on the Initial Command/Response 
Format line of the Parameter Entry Card. 


@ The type of Device Units is set to GDUs (Graphic 
Device Units). 
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The Operator Digitize enable state, if enabled by the 
OPERATOR DIGITIZE command, is canceled. No last 
output block is sent by the Plotter. For GPIB 
Command/Response Formats 5 and 6, the perman- 
ently enabled Digitize state is entered. See Section 
13 for more information. 


The Point light is turned off, except in Com- 
mand/Response Formats 5 and 6 when it is on 
steadily. 
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Section 9 


DEVICE COMMANDS 


CONCEPTS 
Most of the Device commands generate output mes- understand the information on output messages in the 
sages. The form in which these are sent from the Serial Interface or GPIB Interface sections, Sections 4 
Plotter depends on the interface type and Command/ and 5 of this manual. 


Response Formats in use. Thus, it is important to 


COMMAND DESCRIPTIONS 


There are five commands described in this section: e@ IDENTIFY 
@ DEVICE RESET e SIZE 
@ READ STATUS 


The following paragraphs describe each command 
@ READ ERROR separately. 
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DEVICE COMMANDS 


DEVICE RESET 


Purpose: This command resets graphic and alphanumeric parameters to power-up (default) values. 


SERIAL 





AT AD N 


Sample: FcAN 





[selector] 


ie) 





[selector] 





ge 4050 BASIC (Data Byte For) 


PRINT @pa,32: “N” 
Sample: PRINT @1,32: “N”; 


ee See, a a 


Parameters 


selector 
Selector 0-3, omitted selector equivalent to 0 


Comments 


The following is a list of actions that may occur asa 
result of DEVICE RESET command. Those listed with 
an asterisk (*) occur only for certain values of the 
selector argument. (See Table 9-1.) The remaining 
actions take place for all values of this argument. 


1. Alphanumeric parameters are reset to default val- 
ues. This is equivalent to an ALPHA RESET 
command. See the description of this command in 
the Alpha Commands section, Section 10, for a 
complete list of actions. 


2. The following graphics parameters are reset: 


@ The type of Graphic Units is reset to world units 
for both input and output. 


@ The type of Device Units is reset to the default for 
the specific interface and Command/Response 
Format (ADUs for the Serial interface and for 
GPIB Format 7; GDUs for GPIB Formats 1 through 
6). 
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[;selector] 


ie) 


> JS = =——= a a = ee 
bi 
a 


k 
‘ 


SST § ee ee ed! 


The coordinate type is set to absolute. 


Line type is reset to solid. Any defined dash 
patterns are lost, and dash length is set to 0. 


UP is selected for Pen 1. 


The effects of Plotter Transform commands ex- 
cept VIEWPORT and WINDOW are canceled. Any 
stored transforms are lost. (See Section 11 for 
descriptions of these commands.) 


*The numerical ranges of the Viewport and Win- 
dow are reset to initial values. See Section 1 
about the rules for determining numerical ranges. 


The numerical adjustment of the Viewport and 
Window values is important if the Page has been 
altered with the front panel Set Page functions. 
Note that numerical adjustment only occurs when 
a DEVICE RESET command is received (or if the 
Page is SAVEd using the Parameter Entry Card.) 


*The physical size and location of the Page is 
reset to the power-up size and position. This 
effect is equivalent to reselecting the current 
Page Size on the Parameter Entry Card. Any 
alterations to the size and location of the Page by 
front panel Set Page switches are lost. (These 
can be saved by using the SAVE selection on the 
Initial Page Size line of the Parameter Entry Card.) 
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e@ *The clipping control is reset to Viewport clipping. 
(See the SET CLIPPING CONTROL command in 
Section 11.) 


@ *The Formlength is reset to the default value for 
the Page size and location currently in use. This 
length is defined as the distance from the arrow 
on the lower right-hand corner of the platen toa 
distance 1.25 in (31.75 mm) to the left of the Page 
boundary. 


3. Device Status Bits 13 and 14 are set. (See the READ 
STATUS command. The Device Status is returned 
when an argument of 0 is used.) 
®@ Bit 14 (Local Position Modification) is set to 1. 


@ Bit 13 (Local Parameter Modification) is set to 1. 


4. These additional DEVICE RESET actions occur: 


The pen Carriage moves to the load point position. 
*All programmable macros are deleted. 
*All downloaded characters are deleted. 


The Operator Digitize enable state, if enabled by 
the OPERATOR DIGITIZE command, is canceled. 
No last output block is sent by the Plotter. In 
Serial Command/Response Formats 3 and 4 and 
GPIB Formats 5 and 6, the permanently enabled 
Digitize state is enabled. 


@ The Auto Macro state is cancelled, if active. (See 
the AUTO MACRO command in the 
Programmable Macros Section.) 


@ The Point light (on the Plotter front panel) is 
turned off (blinking is stopped. The Point light will 
be on steady in Command/Response Formats 5 
and 6). 


4663 PROGRAMMER'’S REFERENCE 


DEVICE COMMANDS 


Table 9-1 
EFFECTS OF SELECTOR VALUES 








Description of Effects 








All the listed effects except: 
@ The physical size and location of the Page is not 
changed. 





All of the effects of value O except: 
® Programmable macros are not deleted. 
® Downloaded characters are not deleted. 








All the effects of value 1 except: 
@ Viewport and Window values are not changed. 


NOTE 


If the Device Units were changed to a type 
other than the default for the inter- 
face/format in use before the SET WINDOW 


| command was called, a DEVICE RESET 2 


command will result in a distorted Window. 
To restore the correct numerical range to 
the Window, the type of Device Units must 
be set to the type in use when the Window 
was defined. 


@ The current clipping control is not changed. 
@ The Formlength is not changed. 








All the effects of value 1 plus: 
® The physical size and location of the Page is reset. 
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READ STATUS 


Purpose: This command causes the Plotter to generate an output message containing Plotter status information. 


SERIAL 


(One Output Message Block Produced) 


At ADO 


Sample: cAO 


(One Output Message Block Produced) 
Vv 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “Vv”: 
INPUT @ pa,32: 


PRINT @1,32: “Vv”; 
INPUT @1,32: 


Sample: 


4050 BASIC (Secondary Address Form) ' 


PRINT @pa,0: 
INPUT @ pa,32: 
Sample: PRINT @1,0: 
INPUT @1,32: 
Parameters 


status-register-selector 
Status register selector, 0-3 or 0-7 (See Comments) 
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status-register-selector 
1 


status-register-selector 





status-register-selector 
value-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 
(0) 

V1,V2,T 


status-register-selector 
value-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 


oO 
V1,V2,T 


Outputs 


See Comments information. 
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eg 


Comments 


Legal status-register-selector ranges and the type and 


form of status information returned depend on the 
Command/Response Format and interface used. A 


complete description of the status information will be 


given later. There are three distinct cases for input 
argument and output responses: 


1. Serial Command/Response Formats 1 through 2 and 


GPIB Command/Response Formats 1 through 4. 


The legal status-register-selector range is 0-3. Ta- 


ble 9-2 defines Plotter responses. 


2. Serial Interface, Command/Response Formats 3 
and 4. 


The legal status-register-selector range is 0-7. Ta- 


ble 9-3 defines Plotter responses. 


3. GPIB Interface, Command/Response Formats 5 
and 6. 


The legal status-register-selector range is 0-7. Ta- 


ble 9-4 defines Plotter responses. 


NOTE 
For selector values 0-3 and 6-7 only: the output 


message block consists of one, rather than three 
values. If using 4050 BASIC commands, use only 


one target variable; if more are used, the system 
will “hang.” 


Table 9-2 


STATUS INFORMATION FOR SERIAL FORMATS 1 
THROUGH 2 AND GPIB FORMATS 1 THROUGH 4 


























status- Status Information 
register- TAG Value 
selector | Value 1 Value 2 Serial Others 
Format 1 
a 
0 Device Current 4 2 
Status Available 
Memory 
1 Max. Installed 4 Z 
Available | Options 
Memory 
2 Current X-| Current Y- | 4(penup) | 2 (pen up) 
Position | Position | 5 (pen down)|3 (pen down) 
3 Pen Accumu- | 4 2 
Status lated Plot 
Time 
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Table 9-3 
STATUS INFORMATION FOR SERIAL FORMATS 
3 AND 4 
status- Status Information 
register- 
selector | Value 1 Value 2 TAG Value 
—SSE— SSS ———t 
0 0 Device Status 2 
A 1 Current Available 2 
Memory 
2 2 Maximum Available 2 
Memory 
3 3 Installed Options 2 
Current X- | Current Y- 0 (pen up) 
Position Position 4 (pen down) 
5 Current X- | Current Y- O (pen up) 
Position Position 4 (pen down) 
6 Pen Status 2 
7 7 Accumulated Plot 2 
Time 






























































Table 9-4 
STATUS INFORMATION FOR GPIB FORMATS 
5 AND 6 

status- Status Information 
register- 
selector | Value 1 Value 2 TAG Value 
Resa iall bl laa a ee 
(e} Device Status none none 
1 Current Available none none 

Memory 
2 Maximum Available none none 

Memory 

Installed Options none none 

Current X-Position Current Y- | O (pen up) 

Position 1 (pen down) 
5 Current X-Position Current Y- | 0 (pen up) 
_| Position 1 (pen down) 
6 Pen Status none none 
7 Accumulated Plot Time | none none 
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DEVICE COMMANDS 


STATUS INFORMATION 


The following paragraphs describe each word of status 
information that has been shown for this command 
(Device Status, Current Available Memory, Maximum 
Available Memory, Installed Options, Current X and Y 
Position, Pen Status, and Accumulated Plot Time). 


Device Status 


This is a 16-bit integer value in which each binary digit 
indicates if a particular condition is true or false. One 
bit position is unused; thus, 15 conditions may be 
indicated. (See Table 9-5.) A binary value of one for a 
specified position indicates that the state associated 
with that position is true. A zero indicates the state is 
not true. Each bit position is described in subsequent 
paragraphs. Bit 15 is the most-significant bit and Bit 0 
is the least-significant bit. 





























Table 9-5 
DEVICE STATUS BITS 
Bit 
Number Description 
—| 
fe) Internal Error 
1 Command Response Error 
2 Communication Error 
3 Y Below 
4 Y Above 
5 X Left 
6 X Right 
7 Page Y Mirrored 
8 Page X Mirrored 
9 Pause or Busy 
10 Roll Mode 
a Not Used 
a 
12 Loca! Data Reset 
13 Local Parameter Modification 
14 Local Position Modification 
15 Out of Media 





}_ 
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Bit 15 (Out of Media). This bit is only used when 
Media Advance (Option 36) is present and Roll mode is 
selected on the Parameter Entry Card. Bit 15 is set to 
one if an out-of-media condition occurs during any 
media motion. A media advance less than one inch will 
usually result in an out-of-media condition. This bit is 
set to one at power-up (only if Roll mode is selected). 


NOTE 


An out-of-media condition may be incorrectly set 
during manual media motion or front panel Set 
Form Length. This bit value should not be used 
with these functions. 


Bit 14 (Local Position Modification). This bit is set to 
one at power-up, after a DEVICE RESET command, 
whenever the joystick is used, or after the following 
front panel functions are used: all Media group func- 
tions, all Lower Left/Upper Right functions, and 
Initialize. This bit will be set to zero after a READ 
STATUS command that returns Device Status (argu- 
ment of zero). 


This bit permits the host computer program to deter- 
mine if an action occurred locally at the Plotter that 
may have caused a change in position (since the last 
time that Device Status was read.) 


Bit 13 (Local Parameter Modification). This bit is set 
to one during power-up, after a DEVICE RESET com- 
mand, a front panel Set Viewport Lower Left or Upper 
Right, or a front panel Set FormLength has occurred. 
This bit is set to zero after a READ STATUS command 
that requests Device Status (argument of zero). 


A value of one for this status bit signifies that some 
action has occurred locally at the Plotter that may have 
modified programmed parameters. 


Bit 12 (Local Data Reset). This bit is set to one at 
power-up, and after a front panel Data Reset or 
Initialize. It is cleared by a READ STATUS command 
that requests Device Status. Bit 12 indicates that 
commands from a host computer program may have 
been deleted before execution. 
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Bit 11 (Not Used). This bit is always set to zero. 


Bit 10 (Roll Mode). This bit is set to one if Roll mode is 
selected on the Parameter Entry Card. It is zero if Sheet 
mode is selected. 


Bit 9 (Pause or Busy). A Pause/Busy state occurs 
when a front panel Pause state is active or a front 
panel Media function is in process. Under these 
conditions, commands are not executed. However, a 
READ STATUS (0) command will be executed if there 
are no preceding unprocessed commands. 


Bit 8 (Page X Mirrored). This bit is set to one if the 
Page lower-left x-coordinate has been defined to the 
right of the Page upper-right x-coordinate. Bit 8 is set 
to zero otherwise. 


Bit 7 (Page Y Mirrored). This bit is set to one if the 
Page lower left y-coordinate has been defined below 
the Page upper right y-coordinate. Bit 7 is set to zero 
otherwise. 


Bit 6 (X Right), Bit 5 (X Left), Bit 4 (Y Above), Bit 3 
(Y Below). Bits 6 through 3 indicate when the current 
pen position is outside the current clipping limits. 
These limits are defined by the current Viewport 
boundary or Page boundary if Page clipping is 
program-selected (see the SET CLIPPING CONTROL 
command.) 


Refer to Figure 9-1. Left, Right, Above, and Below are 
defined with respect to the horizontally oriented platen 
surface. These directions are not altered by any Page, 
Viewport, or axis-orientation operation. 


X LEFT X RIGHT 
Y ABOVE Y ABOVE Y ABOVE 
X AND Y ON OR 
X LEFT WITHIN CLIPPING X RIGHT 
LIMITS. 

X LEFT X RIGHT 
Y BELOW Y BELOW 


Y BELOW 
Figure 9-1. Clipping Limit Positions. 














3806-66 
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Bit 2 (Communications Error). A communications 
error Such as parity or framing error will set this bit to 
one. The error can be identified using the READ 
ERROR command (if no other error has occurred first). 
This bit is cleared by a front panel Error Reset or by a 
READ ERROR command. 


Bit 1 (Command/Response Error). Com- 
mand/response errors occur when an invalid com- 
mand, argument, or format is received, or when an 
invalid response value results. This bit is cleared by a 
front panei Error Reset or by a READ ERROR com- 
mand. 


Bit O (Internal Error). An internal error condition will 
set this bit to one. A non-fatal error can be cleared by a 
front panel Error Reset or by sending the READ ERROR 
command. 


Current Available Memory 


This integer value is the number of bytes of memory 
currently available in the Plotter for storage of 
programmable macros, downloaded characters, and 
transforms. The numerical range returned is from zero 
to the maximum available memory. On the Serial 
interface, the range is less than the maximum available 
memory. 


Maximum Available Memory 


This is the maximum memory which is available for the 
storage of programmable macros, downloaded charac- 
ters, and transforms. The numerical value depends on 
the interface selected and on which plotter options are 
installed. 
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Installed Options 


This status value indicates which 4663 Plotter options 
are installed. See Table 9-6. The presence of a 
particular option is determined by examining its binary 


position. A value of one indicates the option is present. 


Otherwise, a zero exists for the bit. (Bit 15 is the most 
significant bit while Bit O is the least significant bit.) 


Table 9-6 
INSTALLED OPTIONS STATUS 

















Pen Status 


This status value indicates the currently selected pen 
and if the pen is up or down. See Table 9-7. 


























Table 9-7 
PEN STATUS 

Bit Bit Value Pen Action 

—————— 
Bit 15 to Bits are not used None 
Bit 3 and set to zero 
Bit 2 to Bit 1=1, Bit 2=0 Pen 1 
Bit 1 Bit 1=0, Bit 2=1 Pen 2 
Bit 0 0 Selected pen is up. 

1 Selected pen is down. 





























Bit Description 

Bit 15 to Bit positions 15 through 5 are unused ina 
Bit 5 standard Plotter and are set to zero. 

Bit 4 Math Character Set (Option 32) 

Bit 3 Downloadable Characters (Option 32) 

Bit 2 Programmable Macros (Option 31) 

Bit 1 Circular Interpolation (Option 31) 

Bit O Media Advance (Option 36) 





Current X and Y Position 


These values are the current pen position. The Plotter 
response is the same as with a DIGITIZE command. 
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Accumulated Plot Time 


This is approximately the total number of hours of pen 
carriage motion since the Parameter memory was 
cleared. (A battery within the Plotter maintains Parame- 
ter Entry Card selections and accumulated plot time). 


It is possible that this value will not initialize to zero 
when the Parameter memory is first powered on. For 
this case, only changes in accumulated plot time 
should be considered; the actual value may not be 
meaningful. 


References 


See either the Serial Interface or GPIB Interface 
sections (Sections 4 and 5) for information about 
decoding output responses. 
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Purpose: This command causes the Plotter to transmit a two-block message containing error information. In 
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first-value-1 -target-variable, 
first-value-2-target-variable, 
first-tag-value-target-variable 


= 
_— 
READ ERROR 
| addition, the front panel Error Reset light is turned off, and the error data is cleared. 
SERIAL 
(Command/Response Formats 1-2 Only) 
vat (Two Output Message Blocks Produced) 
At An CE 
Ec ACE 
) 
= (Two Output Message Blocks Produced) 
CE 
=" 
r= 4050 BASIC (Data Byte Form) 
" PRINT @pa,32: “CE” 
= INPUT @ pa,32: 
= INPUT @pa,32: 
w Sample: PRINT @1,32: “CE” 
INPUT @1,32: 
INPUT @1,32: 
vee 
Outputs 
a 
First output message block: 
value 1 
Error-number x 256 + error-count 
vv 
value 2 
Error-parameter-1 x 256 + error-parameter-2 
tag value 
= See Table 9-8. 
Last output message block: 
- value 7 
Error-parameter-3 x 256 + error-parameter-4 
value 2 
i Error-parameter-5 x 256 + error-parameter-6 
tag value 
“ww —sCSSSeee Table 9-8. 
= 


last-value-1-target-variable, 
last-value-2-target-variable, 
last-tag-value-target-variable 


V1,V2,T1 
V3,V4,T2 


Eight items of information are included in the outputs. 
Each has an integer value in the range 0-255: 


error-number 
Identifies the error that occurred. A value of zero 
indicates no error. 


error-count 
This is the total number of errors that have occurred 
since power-up or the last time an error was cleared. 
(See Comments). 


error-parameters-1 through -6 
These give information on the internal source and 
cause of the error. They are intended for debugging 
use only. One or more parameters are set for each 
error reported. 
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Table 9-8 


TAG VALUES FOR READ ERROR COMMAND 























TAG Serial GPIB 

Meaning Formats Formats 
1 1 thru 6 

First Block 0 

Last Block 2 

Comments 


The error-number information identifies the first error 
that occurs after power-up or since the last READ 
ERROR command or front panel Error Reset function. 
Subsequent errors increment the error-count. 
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References 


See either the Serial Interface or GPIB Interface 
sections (Sections 4 and 5) for information on decod- 
ing output responses from the Plotter. 


Also, see Appendix J for descriptions of error numbers. 


Errors 


Error 48 
(Invalid Command for Selected Output Format) 
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IDENTIFY 


Purpose: This command causes the Plotter to transmit a one-block message that identifies the Plotter, the amount 
of memory installed, and the firmware release number. 


SERIAL 
(Command/Response Formats 1-2 Only) 
(One Output Message Block Produced) 
Ar 4p Q 
E-AQ 


(Command/Response Formats 1-4 Only) 
(One Output Message Block Produced) 





4050 BASIC (Data Byte Form) = 
(Command/Response Formats 1-4 Only) 


PRINT @pa,32: “I” 

INPUT @pa,32: vaiue-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 

Sample: PRINT @1,32: “I” V1,V2,T 

INPUT @1,32: V1,V2,T 


== 4050 BASIC (Secondary Address Form) @==== ' 
(Command/Response Formats 1-4 Only) 


INPUT @ pal, 13]: value-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 


Sample: INPUT @1,13: Vv1,V2,T 
Outputs Two items of output information are returned in value 2: 
value 7 @ number-kilobytes-memory is the amount of memory 
4663 (Plotter model number) (RAM) installed (8 for a standard Plotter). 
value 2 ® firmware-release-number is an integer value indicat- 
Number-kilobytes-memory x 256 + firmware- ing the version number of the firmware installed in 
release-number the Plotter. 
tag value 
See Table 9-9. 
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Reference 


See either Section 4 or Section 5 for information on 
decoding output responses from the Plotter. 


See the SIZE command if the Plotter uses other than 


the Command/Response Formats indicated in Table 
9-9. 
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Table 9-9 
TAG VALUES FOR IDENTIFY COMMAND 
Format TAG Value 
———— 

Serial Format 1 4 

Serial Format 2 2 

GPIB Formats 2 

1 through 4 
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Purpose: This command causes the Plotter to transmit a one-block message that gives the size of the plotting 


area and an identification word. 


(Command/Response Formats 3-4 Only) 
(One Output Message Block Produced) 


Ar AD Q 


FceAQ 


(Command/Response Formats 5-6 Only) 
(One Output Message Block Produced) 


=4050 BASIC (Data Byte Form) « 


(Command/Response Formats 5-6 Only) 


PRINT @pa,32: “I” 
INPUT @pa,32: 


Sample: PRINT @1,32: “I” 
INPUT @1,32: 


4050 BASIC (Secondary Address Form) 


(Command/Response Formats 5-6 Only) 


INPUT @pal,13]: 


Sample: INPUT @1,13: 


—== 


Outputs 


Output information is interface-dependent, as follows: 


Serial Interface: 

value 7 
5649 (represents x-size x 256 + y-size, where 
x-size equals 22 in and y-size equals 17 in) 


value 2 
Identification word (see Table 9-10) 


tag value 
3 
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value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 


V1,V2,T 


value-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 


V1,V2,T 


GPIB Interface: 
value 7 
150 (represents x-size in GDUs) 


value 2 
100 (represents y-size in GDUs) 


tag value 
Identification word (see Table 9-10) 
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Table 9-10 
IDENTIFICATION WORD 
Bit® Information 
Bit 0 to Firmware release number. 
Bit 3 
Bit 4 and Both bits are set to one indicating that 
Bit 5 more than 1600 bytes are available at power- 
up for the input buffer. 
Bit 6 Media Advance Installed (Option 36) 
Bit 7 Circular Interpolation Installed (Option 31) 
Bit 8 Programmable Macros Installed (Option 31) 
Bit 9 Downloadable Characters Installed (Option 32) 
Bit 10 Math Character Set Installed (Option 32) 
Bit 11 to Set to zero on standard Plotter. 
Bit 15 








Bit O Is the least-significant bit. 


9-14 


References 


See either Section 4 or Section 5 for information on 
decoding output responses from the Plotter. 


See the IDENTIFY command if the Plotter uses Com- 
mand/Response Formats other than those listed in the 
syntax boxes. 
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Section 10 


ALPHA COMMANDS 


INTRODUCTION 
The Plotter has an internal alpha generator that Table 10-1 
enables the user to print and position alphanumeric 
characters and symbols which are defined in nine INTERRELATIONSHIPS OF ALPHA SETUP AND 
resident fonts. (With Option 32 installed, 16 fonts are ACTION COMMANDS 

































































available.) Four action commands and twelve setup 
commands are available. Refer to Table 10-1. Action Commands 

Setup Commands 
For the PRINT action command, the alpha generater Print Move To Character 
prints 96 ASCII characters (8p through °.) and _{FOnt Santered rome _| Move 
responds to the nine control characters (8. through §)). SET ALPHA SIZE x |x x x 
For the other three action commands listed in Table al 
10-1, the alpha generator prints symbols centered SET ALPHA RATIO x —— X 
about the current pen carriage position (PRINT CEN- SET ALPHA X X xX xX 
TERED command), moves the pen carriage a specified DIMENSION Stik 
number of character spaces and line spaces (CHAR- SET ALPHA ROTATIONIX IX x Xx 
ACTER MOVE command), or moves the pen carriage to (Angle) 

7 at a asl ae position on the Viewport (MOVE TO Sey ALPHA ROTATION|X 
(Left Margin) 
—__—+ == 

The alpha setup commands, and the Alpha Character SET ALPHA SLANT me X 
Quality line on the Parameter Entry Card are used to SET ALPHA SCALE Xx X X 
control the four alpha action commands. Refer again to 
Table 10-1 for the interrelationship between the setup SET TAB SEPARATION |X = 
commands and the action commands. This section SET ALPHA MARGIN |X xX 
includes fundamental alpha concepts and descriptions SEPARATION 
of the resident character sets, followed by more SELECT ALPHA x R 
information for each setup and action command. SPACING CONTROL 

SELECT STANDARD xX xX Sail 

ALPHA FONT (If active)! _| 

SELECT ALTERNATE |X X 

ALPHA FONT (If active) 

RESET ALPHA xX xX x xX 

PARAMETERS | 

SET ARC x x 

SMOOTHNESS Pt 




















| ALPHA SLANT affects noncontrol characters only. 
Default ALPHA SPACING CONTROL is recommended. 
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CONCEPTS 


The following general concepts are presented here: 


PRINT Command Fundamentals 

The Automatic Move-To-Home Function 

The Home Position 

Setting Size and Spacing of Printed Characters 
Resident Alpha Fonts 

Spacing Control for the PRINT Command 


Adding Margin Control for PRINT and CHARACTER 
MOVE Commands 


PRINT COMMAND FUNDAMENTALS 


For each character (8p through 9) within a PRINT 
command, the alpha generator does the following: 


@ Moves and Draws as necessary to print the selected 
character with the character’s lower-left corner 
located at the current pen position. 


@ Moves to the start point for the next character (as 
determined by the SET ALPHA SIZE, SET ALPHA 
RATIO, and SET ALPHA SCALE set-up commands). 


The alpha generator prints characters from the active 
font, according to all alpha setup commands for size, 
rotation, slant, scale, etc. The alpha generator also 
processes contro! characters ®: through S$). The PRINT 
command procedure just described applies for all 
setups where default SELECT ALPHA SPACING CON- 
TROL and SET ALPHA MARGIN SEPARATION com- 
mands apply. (Spacing control and margin control are 
described later in this section.) 


THE AUTOMATIC MOVE-TO-HOME 
FUNCTION 


The Plotter expects the first PRINT command after 
power-up to be preceded by a MOVE or DRAW 
command or Joystick action. If this expectation is not 
met, the Plotter takes corrective action by preceding 
the PRINT command with a Move-To-Home action. (The 
home position is defined below.) The automatic Move- 
To-Home function also applies for the first PRINT 
command after a front panel Media Change, Locate 
Lower Left, or Locate Upper Right action. 
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THE HOME POSITION 


The home position is a point located one character 
height below the upper left corner of the Viewport. (if 
the alpha rotation angle is nonzero, the home position 
is rotated by this angle about the upper-left corner of 
the Viewport.) 


SETTING THE SIZE AND SPACING 
OF PRINTED CHARACTERS 


Either the SET ALPHA SIZE or the SET ALPHA 
DIMENSION commands sets the character width and 
height used by alpha action commands. Both com- 
mands are specified in terms of Initial Window units; 
current Window parameters, if different, have no effect. 
Default sizes are described in the description of the 
SET ALPHA SIZE command. 


The spacing between characters is determined by the 
SET ALPHA RATIO command, in conjunction with 
character width and character height. The relationship 
between these setup parameters, pen position, and the 
printed character is illustrated for the PRINT command 
in Figure 10-1. 


Both the character size and spacing can be increased 
or decreased by an additional setup command: the 
SET ALPHA SCALE command. For example, alpha 
scale factors of 2,2 set the size and spacing of printed 
characters and character moves to be two times the 
size and spacing of the default scale factor. 
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Figure 10-1. Alpha Size and Spacing for the PRINT Command. 
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ALPHA COMMANDS 


RESIDENT ALPHA FONTS 


The alpha generator has resident character definitions 
for ASCII characters Sp through ®°L in nine fonts (or in 
12 resident fonts if Option 32 is installed). Nine 
resident fonts are available for NORMAL or ENHANCED 
selections of the Alpha Character Quality fine on the 
Parameter Entry Card. NORMAL quality characters use 
fewer Moves and Draws and are printed more quickly 
than the ENHANCED characters. ENHANCED quality 
characters offer added smoothness (which can be 
controlled by the SET ARC SMOOTHNESS command). 
The nine resident alpha fonts are shown in Figures 
10-2 (NORMAL) and 10-3 (ENHANCED) with the 


FONT 0 CHARACTER SET: 
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Figure 10-2. NORMAL Alpha Character Quality. 
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complete Font 0 shown at the top of the figures. Font 0 
includes two nonprinting characters, Sp and ®L. (The L 
character is a nonprinting and nonadvancing charac- 
ter.) All other fonts are identical to Font O except for the 
character substitutions shown in Figures 10-2 and 
10-3. 


For Option 32, additional character definitions are 
resident in Fonts 10, 11, and 15. Fonts 10 and 11 are 
shown in Figures 10-4 and 10-5. All characters 
unchanged from Font 0 are shaded and are shown with 
ENHANCED alpha character quality. 


FONT @ CHARACTER SET: 
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Figure 10-3. ENHANCED Alpha Character Quality. 
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Figure 10-4. Resident Font 10 (Option 32). 
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Figure 10-5. Resident Font 11 (Option 32). 
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NOTE 


Character definitions provided by Option 32 are 
NOT affected by the Alpha Character Quality line 
on the Parameter Entry Card. When Option 32 

= characters are mixed with other resident charac- 
ters, be sure to select the proper alpha character 
quality, so that all characters will have the same 


oo alpha quality as the Option 32 characters. Select 
ENHANCED quality when using resident fonts 10 
and 117. 

oa Option 32 provides a single character substitution in 


Font 15 (other characters are the same as in Font 0). 
The new character replaces ° and consists of a grid 
that covers the usual extremes for printed letters 
- (including the descender region for some lowercase 
letters) — a tool useful when designing new characters. 
Figure 10-6 shows three copies of this special 
character, with an X and a y superimposed over the last 


- two. 
For details on how to select and activate a font number, 

ia see the descriptions of the SET STANDARD ALPHA 
FONT and SET ALTERNATE ALPHA FONT commands 
in this section. For information on how to create a new 
character definition, or a new font, see Section 15. 

= 
SPACING CONTROL FOR THE PRINT 
COMMAND 

a 


The SELECT ALPHA SPACING CONTROL set-up 
command controls PRINT command actions. For a 
selection of zero, subsequent PRINT actions allocate a 
= constant width for each character, printing narrow 
characters at the center of this region. The distance 
from the start of the region allocated for one character 
to the start of the next is constant. For a selection of 


= one, the alpha generator does the following for each 
character printed (based on the actual width of the 
character): 
= 1. The selected character is printed (by Moves and 
Draws) such that the character’s left edge is 
located at the current pen carriage position. 
- 

2. Then the pen carriage moves to the start point for 
the next character (a constant distance from the 
right edge of the character just printed). 

a 
] 

ned 
st 


4663 PROGRAMMER’S REFERENCE 





ALPHA COMMANDS 


For either selection, the spacing between typical 
uppercase letters (for example, A’s) is identical, as 
defined by the SET ALPHA RATIO command. For the 
default selection of zero, additional space is added 
before and after narrow characters (for example, i’s). 
For the selection of one, the spacing from the end of 
one character to the start of the next is constant. 
Figure 10-7 shows the same words printed with 
spacing control selections set to zero (the default) and 


one. 
























































Figure 10-6. The Grid Character in Font 15 (Option 32). 


(a) Audio equipment with infinite fidelity. 


(Aipha separation = 4) 


(b) Audio equipment with infinite fidelity. 


(Alpha separation = !) 





Figure 10-7. Comparison of Alpha Spacing Control 
Selections. 
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ALPHA COMMANDS 


ADDING MARGIN CONTROL FOR PRINT 2. The alpha generator prints the character and 
AND CHARACTER MOVE COMMANDS moves to the origin of the next character. 


The SET MARGIN SEPARATION command activates 3. If the new origin is to the right of the right margin, 
margin control whenever a separation greater than zero the alpha generator performs a Carriage Return 
character spaces is specified. With margin control and a Linefeed. 

active, the Plotter uses the following procedure for 


each character printed: For the CHARACTER MOVE command the alpha gener- 


ator performs margin control according to this third 
1. If the character is too wide to fit within the right Step. 
margin, the alpha generator performs a Carriage 
Return and a Linefeed. If the pen carriage is to the 
left of the left margin, the pen carriage moves to the 
left margin. 


COMMAND DESCRIPTIONS 


SET TAB SEPARATION CHARACTER MOVE 


SET ALPHA MARGIN SEPARATION 


There are 16 commands described in this section: @ SELECT ALPHA SPACING CONTROL 
© SET ALPHA SIZE @ SELECT STANDARD ALPHA FONT 

@ SET ALPHA RATIO @ SELECT ALTERNATE ALPHA FONT 
@ SET ALPHA DIMENSION @ RESET ALPHA PARAMETERS 

@ SET ALPHA ROTATION ERIN 

o Ser Alea Sear @ PRINT CENTERED 

@ SET ALPHA SCALE ® MOVE-TO-HOME 

e e 

td 


The following pages describe each command separately. 
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ALPHA COMMANDS 


w 
SET ALPHA SIZE 


Purpose: This command sets the character width and the character height for a typical uppercase letter (for 
example, A). The width and height, specified in Initial World Units, are used by all subsequent alpha action 
commands. 


SERIAL 





At Ap BZ character-width,character-height 
Sample: cABZ 12,22 


character-width,character-height 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “BZ”; character-width;character-height 
Sample: PRINT@1,32: “BZ”; 12;22 
, Parameters Comments 

character-width The default alpha size (set at power-up or after an 
Width of a typical uppercase letter, in Initial World ALPHA RESET or DEVICE RESET command) depends 
Units on the selection of Device Units and on the size of the 

Initial Window. The default Device Units are ADUs for a 

character-height ee Serial interface and GDUs for a GPIB interface. Table 
Height of a typical uppercase letter, in Initial World 10-2 shows default alpha sizes for C-SIZE, DRAFTING, 
Units and HORIZONTAL selections on the Parameter Entry 


Card. Table 10-3 shows how to calculate default alpha 
size for any Parameter Entry Card selection. Alpha size 
is expressed in Table 10-3 as a fraction of the longer 
axis of the Viewport or Initial Window. To determine 
PHYSICAL size, replace L with the physical length of 
the longer axis of the Viewport. To determine numerical 
size, replace L with the numerical range of the longer 
axis of the Initial Window. 
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Table 10-2 


DEFAULT ALPHA SIZE FOR C-SIZE/DRAFTING/HORIZONTAL 
PARAMETER ENTRY CARD SELECTIONS 







































































Device Aspect Character Character Character Line 
Units Ratio Width Height Space® Space? 
+ —————— 
ADU (Addressable Device Units) (Any) 37 1/3 53 7/9 56 88 
Default for Serial interface 
) 
GDU (Graphic Device Units) FULL 1.079 1.554 1.619 2.543 
Default for GPIB Interface 
3X:2Y 1.195 1.721 1.792 2.816 
4X:3Y 1.044 1.504 1.566 2.461 
1X:1Y 0.796 1.147 1.195 1.877 
3X:4Y 1.044 1.504 1.566 2.461 
2X:3Y 1.195 1.721 1.792 2.816 
—————S = 
mm (millimeters) FULL 4.248 6.119 6.372 10.014 
3X:2Y 4.248 6.119 6.372 10.014 
4X:3Y 4.1411 5.922 6.167 9.691 
TREATY 3.136 4.517 4.703 7.391 
3X:4Y 3.136 4.517 4.703 7.391 
2X:3Y 3.136 4.517 4.703 7.391 
®Character space and line Space values only apply to default ALPHA RATIO selections. 
Table 10-3 References 
DEFAULT ALPHA SIZE The SET ALPHA DIMENSION command may be used 
instead of this command. 
Device Units Alpha Size4 
Width Height 
ADU (7/768)L or (121/9216)L or 
approx .009115L approx .01313L 
GDU or mm (224/281 25)L or (968/84375)L or 
approx .007964L approx .01147L 








aL is the longer axis length of the Initial Window or Viewport. 


10-16 


4663 PROGRAMMER'S REFERENCE 


SET ALPHA RATIO 


ALPHA COMMANDS 


Purpose: This command specifies the ratio of character space to character width and the ratio of line space to 
character height. These ratios (and the character width and character height) are used by subsequent PRINT and 


CHARACTER MOVE Commands. 


SERIAL 





At Ap BI 


Sample: Fc ABI 





x-ratio,y-ratio 
2,1.7 


x-ratio,y-ratio 





4050 BASIC (Data Byte Form) : 


PRINT @ pa,32: “BI”; 


Sample: PRINT @1,32: “BI”; 


Parameters 


x-ratio 
Character space divided by character width 


y-ratio 
Line space divided by character height 


Comments 


The default x-ratio and y-ratio values are 3/2 and 
18/11, respectively. The product of x-ratio (or y-ratio) 
and character width (or height) is used to determine 
the character space (or line space) distance. These 
distances are used by subsequent CHARACTER MOVE 
commands and PRINT commands for determining the 
next character position. 
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x-ratio;y-ratio 
2;1.7 


A negative x-ratio will cause a reversal in direction for 
PRINT command advance-to-next-character actions, 
and for ®s and 4+ actions. For instance, an x-ratio of 
—1.5 (assuming default alpha spacing control) will 
cause printed characters to be positioned in a row from 
right to left; the printing of characters will NOT be 
reversed. 


A negative y-ratio will reverse the direction of PRINT ‘r 
and Yr actions. 


Examples 


The samples in the syntax boxes show how to specify a 
character space (the distance from the start of one 
typical uppercase letter to the start of the next) that is 
two times the character width, and a line space (the 
distance from the baseline for one line of printed 
characters to the next baseline above it) that is 1.7 
times the character height. 
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SET ALPHA DIMENSION 


Purpose: This command sets the width and height for a typical uppercase letter (such as A). The Plotter divides 
the specified character space and line space by the current alpha ratio values to determine character width and 


height. 


SERIAL 


AT Ap I 


Sample: cAI 


4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “S”; 
Sample: PRINT @1,32: “S”; 


4050 BASIC (Secondary Address Form) 


PRINT @pa,17: 
Sample: PRINT @1,17: 


Parameters 


character-space 
Distance from the beginning of a typical uppercase 
letter to the beginning of the next, in Initial World 
Units 


line-space 
Distance from the baseline for one line of printed 
characters to the next baseline above it, in Initial 
World Units 
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character-space,line-space 
18,36 


character-space,line-space 





character-space;line-space 
18;36 


character-space;line-space 
18;36 


Comments 

This is an alternate form of the SET ALPHA SIZE 
command. 

Examples 


The samples in the syntax boxes above set arguments 
of 18 and 36 which, for default alpha ratio values 3/2 
and 18/11, are equivalent to arguments of 12 and 22 in 
a SET ALPHA SIZE command. 
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Purpose: This command (1) sets the alpha rotation angle specified in degrees and (2) sets the left margin (asa 





us 
dl 
| SET ALPHA ROTATION 
al 
subsequent alpha action commands. 
SERIAL 
a 
AT Ad J 
Sample: fcAJ 
a 
" 
4050 BASIC (Data Byte Form) 
= PRINT @ pa,32: “R”; 
Sample: PRINT @1,32: “R”; 
aa 
4050 BASIC (Secondary Address Form): 
9 PRINT @ pa,25: 
= Sample: PRINT@1,25: 
Parameters 
-) 
rotation-angle 
The angle of rotation counterclockwise, in degrees 
ol Comments 
The default rotation angle is 0°, and the default left 
margin is the left side of the Window. 
- 
NOTE 
The SET WINDOW command also sets the left 
- margin as a line that goes through the upper left 
corner of the Window and is perpendicular to the 
printing direction. 
= The left margin is used for (1) carriage return, (2) 
margin control (if active), and (3) as a tab spacing 
reference. For details on margin contro! and tab 
spacing, see the descriptions for the SET TAB SEPAR- 
- ATION and SET MARGIN SEPARATION commands. 
= 
—_ 
at 
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line that goes through the current pen carriage position and is perpendicular to the printing direction) used by 





rotation-angle 
30 


rotation-angle 





rotation-angle 
30 


rotation-angle 
30 


Examples 


The samples in the syntax boxes show how to specify a 
30° counterclockwise rotation angle, and how to set the 
left margin at the current pen carriage position. Figure 
10-8 shows the effect of a 30° alpha rotation on 
subsequent PRINT command actions. 


NEW LEFT MARGIN 


Pen position after 
SET ALPHA ROTATION 
command anve-46 


Figure 10-8. Alpha Rotation of 0° and 30°. 
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SET ALPHA SLANT 


Purpose: This command sets the alpha slant angle in degrees used by subsequent PRINT CENTERED and PRINT 


commands (for noncontrol characters only). 


SERIAL 





Ay Ap BG 
Sample:  cABG 





=» 4050 BASIC (Data Byte Form) mssssssesn= 


PRINT @ pa,32: “BG”; 
f Sample: PRINT@1,32: “BG”; 





WoT a Se SS aE 1 Sa a a 


Parameters 


Slant-angle 
The clockwise slant angle, in degrees (default value 
is 0°) 


Comments 


Subsequent PRINT or PRINT CENTERED commands 
produce characters with all portions above and below 
the baseline slanted clockwise the specified angle from 
a vertical axis. Character height does not change. 


The slant angle is not used for CHARACTER MOVE 
command actions or for control character (for example, 
Le and Yr) actions of PRINT commands. 


Angles from 89.9° to 90.1° and from 269.9° to 270.1° 
are converted to 89.9°. 
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slant-angle 
20 


slant-angle 


slant-angle 
20 


Examples 


The samples in the syntax boxes show how to specify a —" 


20° clockwise slant angle for subsequent PRINT or 
PRINT CENTERED command actions. Figure 10-9 
shows the effect of a 20° alpha slant on subsequent 
PRINT command actions. 


ZERO WWENTY 


3806-47 





Figure 10-9. Alpha Slant of 0° and 20°. 
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Purpose: This command sets the X-axis and Y-axis magnification factors used by all subsequent alpha action 








x-mag-factor,y-mag-factor 
2,3 


x-mag-factor,y-mag-factor 





-— 
SET ALPHA SCALE 
commands. 
SERIAL 
Ay Ap BH 
Sample: cA BH 
»4050 BASIC (Data Byte Form) 
PRINT @ pa,32: “BH”; 
Sample: PRINT@ 1,32: “BH”; 
Parameters 
“ww” x-mag-factor 


X-axis magnification factor 


y-mag-factor 
Y-axis magnification factor 
Comments 
Default values for magnification factors are 1,1. Nega- 


tive values reverse the printing and spacing associated 
with alpha action commands. 
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x-mag-factor; y-mag-factor 
2;3 


Examples 


The samples in the syntax boxes above cause all 
subsequent printing and the associated spacing be- 
tween characters to be twice as wide and three times 
as high as produced with default parameters for this 
command. 
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SET TAB SEPARATION 


Purpose: This command activates the horizontal tab function and sets the distance between tabs (and from the 
left margin to the first tab position) equal to the specified number of spaces of the current size. This information is 
used by subsequent PRINT commands containing the 4+ character. A value of zero (default) disables the tab function 


and causes the "+ character to be printed as a Sp character. 


SERIAL 





AT Ap BT 


Sample: fc ABT 


tab-separation 
8 


tab-separation 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “BT”; 


Sample: PRINT@1,32: “BT”; 


Parameters 


tab-separation 
Tab separation, as the number of character spaces, 
sign ignored 


Comments 


The horizontal tab separation defines a series of 
equally spaced tab positions (stops) starting one tab 
separation distance to the right of the left margin. For 
each 4+ character in subsequent PRINT commands, the 
Plotter moves along the current printing direction to the 
next tab position beyond the current pen carriage 
position. 
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tab-separation 
8 


The tab separation distance is set according to the 
current alpha size, alpha ratio, and alpha scale 
parameters. Subsequent changes in the alpha size, 
alpha dimension, alpha ratio, or alpha scale specifica- 
tions do not modify tab separation. This means that 
character size and spacing parameters can be 
changed without affecting previously defined tab posi- 
tions. 


Examples 


The samples in the syntax boxes show how to set a tab 
separation of eight spaces of the current size, which 
defines a series of tab positions that are 8, 16, 24, etc. 
spaces from the left margin. 
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SET ALPHA MARGIN SEPARATION 


ALPHA COMMANDS 


Purpose: This command activates the margin contro! function and sets the right margin a specified distance from 
the left margin. MARGIN CONTROL is used for subsequent PRINT and CHARACTER MOVE command actions. A 


margin separation of zero (default) disables margin control. 


SERIAL 





At Ap BR 


Sample: fc ABR 





margin-separation 
50 


margin-separation 





4050 BASIC (Data Byte Form): 


PRINT @ pa,32: “BR”; 


Sample: PRINT@ 1,32: “BR”; 


Parameters 


margin-separation 
Distance between margins, as number of character 
spaces, sign ignored 


Comments 


The alpha margin separation distance defines a right 
margin that is parallel to and to the right of the left 
margin. Subsequent changes to the left margin will 
cause corresponding changes to the right margin. (For 
details on how to set the left margin, see the descrip- 
tion of the SET ALPHA ROTATION command.) 


The alpha margin separation distance is set according 
to the current alpha size, alpha ratio, and alpha scale 
parameters. Subsequent changes in the alpha size, 
alpha dimension, alpha ratio, or alpha scale specifica- 
tions will not modify the margin separation. This means 
that character size and spacing parameters can be 
changed without affecting previously defined margins. 
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margin-separation 
50 


When the alpha margin separation is set to be non- 
zero, subsequent PRINT commands obey the following 
rules for each character: 


1. For printable ASCII characters (Sp through ®L) only, 
if the current pen position is to the right of the right 
margin, or if a typical uppercase letter would 
extend beyond the right margin, the alpha 
generator performs a PRINT °r ‘r command prior to 
printing the specified character. If the current pen 
position is to the left of the left margin, the alpha 
generator performs a PRINT °r command prior to 
printing the specified character. 


2. The alpha generator prints the specified character 
and moves to the origin of the next character. 


3. If the new pen carriage position is to the right of 
the right margin, the alpha generator performs a 
PRINT ©r e command. 


For the CHARACTER MOVE command, the alpha 
generator performs margin control according to the 
third step. 

References 


For information on how to set the left margin, see the 
description of the SET ALPHA ROTATION command. 
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SELECT ALPHA SPACING CONTROL 


Purpose: This command selects the type of alpha spacing control used by subsequent PRINT commands. A 
selection of zero (the default) produces a constant start-to-start spacing of characters. A selection of one produces 


a constant end-to-start spacing of characters. 


SERIAL 





AT Ap Ad 


Sample: ec AAJ 


spacing-control-selector 
1 


spacing-control-selector 





4050 BASIC (Data Byte Form) : 


PRINT @ pa,32: “AJ”; 


Sample: PRINT@1,32: “AJ”; 


Parameters 


spacing-control-selector 
Spacing control selector, 0-1: 
e O= constant start-to-start 
e 1= constant end-to-start 


Comments 


Refer back to Figure 10-7. For the default selection of 
zero, subsequent print actions assume that all charac- 
ters are of equal width (that of a typical uppercase 
letter, such as A). Narrow characters (for example, i) 
are printed near the center of the allocated character 
width. With ALPHA SPACING CONTROL set to one, the 
space allocated to each character varies such that the 
distance between characters is constant. This space is 
equal to the distance between uppercase H and M. 
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spacing-control-selector 
1 


References 


See Spacing Control! for the PRINT Command, earlier in 
this section. 
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— 
| SELECT STANDARD ALPHA FONT 


Purpose: This command selects the standard font that, when active, is used by subsequent PRINT or PRINT 
) CENTERED commands. 


SERIAL 










‘/ ATADT standard-font-selector 
Sample: fcAT 1 











‘va 
standard-font-selector 
all 
wm PRINT @ pa,32: “F”: standard-font-selector 
Sample: PRINT@1,32: “F”; 1 
= r; 4050 BASIC (Secondary Address Form) semen =e 
PRINT @ pa, 18: standard-font-selector 
- Sample: PRINT@I,18: 
at 
Parameters NOTE 
standard-font-selector Serial interface only: For Style-Il command appli- 
= Standard font selector, 0-15 cations, use “1 80 and “1 1 sequences to active 
the alternate or standard font (or use Style-! 
PRINT commands). Any §o or $1 characters 
Comments received in Alpha mode will be ignored. 
= This command selects the standard font, which is 
activated by control characters within a PRINT com- 
mand: 
a P 
@ When the Plotter receives an ASCII So (Shift Out) 
control character, the alternate font is activated. 
= @ When the Plotter receives an ASCII § (Shift In) 
control character, the standard font is activated. The 
default active font is the standard font. 
a 
— 
_ 
| 
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SELECT ALTERNATE ALPHA FONT 


Purpose: This command selects the alternate font that, when active, is used by subsequent PRINT or PRINT 
CENTERED commands. 


SERIAL 





At Ap BQ alternate-font-selector 
Sample: fc ABQ 2 


alternate-font-selector 





» 4050 Basic (Data Byte Form) 


PRINT @pa,32: “BQ”; alternate-font-selector 
Sample: PRINT @1,32: “BQ”; 2 
Parameters NOTE 
alternate-font-selector Serial interface only: For Style-Il command appli- 
Alternate font selector. 0-15 cations, use “7 80 and “7 S| sequences to active 


the alternate or standard font (or use Style-/ 
PRINT commands). Any 80 or $i: characters re- 


Comments ceived in Alpha mode will be ignored. 
This command selects the alternate font, which is 
activated by control characters within a PRINT com- References 
mand: 
See the Resident Alpha Fonts discussion earlier in this 
@ When the Plotter receives an ASCII So (Shift Out) section for descriptions of available fonts. See the 
control character, the alternate font is activated. SELECT STANDARD ALPHA FONT command for 


information on how to select the standard font. 
@ When the Plotter receives an ASCII § (Shift In) 


control character, the standard font is activated. The 
default active font is the standard font. 
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- 


RESET ALPHA PARAMETERS 


Purpose: This command resets alpha parameters to their default (power-up) values. 


SERIAL 


ATADV 


Sample: FcAV 


GPIB 


4050 Basic (Data Byte Form) 


PRINT @pa,32: “A” 
Sample: PRINT @1,32: “A” 


4050 BASIC (Secondary Address Form) 


PRINT @pa,7: 
Sample: PRINT @1,7: 


Comments 


The RESET ALPHA PARAMETER command establishes 
default parameters for the alpha setup commands 
shown in Table 10-4. 


This command does not affect values set by the SET 
ARC SMOOTHNESS command and does not affect the 
Parameter Entry Card selection for Alpha Character 
Quality. 
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Table 10-4 


ALPHA COMMANDS 





DEFAULT PARAMETERS FOR RESET ALPHA 
PARAMETER COMMAND® 





Command 


Default Parameter 








SET ALPHA SIZE 


SET ALPHA RATIO 

SET ALPHA ROTATION 

SET ALPHA SLANT 

SET ALPHA SCALE 

SELECT STANDARD ALPHA FONT 

SELECT ALTERNATE ALPHA FONT 
SET ALPHA MARGIN SEPARATION 


SET TAB SEPARATION 
SELECT ALPHA SPACING CONTROL 





(Set to the default 
size listed in Table 
10-3.) 


3/2, 18/11 
0° 

0° 

11 

0 

0 


0 (Margin control 
inactive.) 


O (4+ treated as Sp) 


0 (Constant spacing 
between character 
origins.) 








aloft margin Is set at the left edge of the Viewport. Standard alpha font is 


activated. 
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PRINT 


Purpose: This command causes the specified ASCII characters to be printed, according to all alpha parameters 
currently defined. After each character is printed, the pen carriage moves to the origin for the next character. 


SERIAL 





AT Ap P string 
Sample: Fc AP “ABC”/68’EFG’ 


print-string 





4050 Basic (Data Byte Form) ace 


PRINT @pa,32: “P print-string” ; 
Sample: PRINT @1,32: “P ABCDEFG” ; 


ea SSS 


r= 4050 BASIC (Secondary Address Form) === 


i PRINT @pa,12: “print-string” ; { 
: Sample: PRINT @1,12: “ABCDEFG” ; 
| OSS 25a Pee ES 28 ee A © ie = - exe es aT RTE ae! 
g= 4050 BASIC (Special Keyword Form) «mnt aeons 
i PRINT @ pal, 1 2): “print-string” ; F 
) Sample: PRINT @1: “ABCDEFG” ; H 
i a & a -_ = ; fn 
Parameters Comments 
print-string or string The PRINT command is used to print any of the 96 

Represents one or more ASCII characters: ASCII characters Sp through ®t and/or to process 

e ®g through 1 and control characters ®. through §:. (For most fonts, Se and 

e Sp through PL DP. are non-printing and "1 is non-advancing,) The 

(Other control characters are ignored) PRINT command prints each character according to 


current alpha setup command parameters. Control 
characters are processed as listed in Table 10-5 (other 
control characters are ignored). Control character 
processes are not affected by the SET ALPHA SLANT 
command or by character defining commands provided 
by Option 32. 
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ae 
CONTROL CHARACTER RESPONSES 
Character Action 
- By Rings the bell. 
Bg Moves the pen carriage left one character 
space. 
vs = 
T Moves the pen carriage to the next tab 
position to the right. If the tab separation is 0, 
H+ is treated as a Sp. 
a Le Moves the pen carriage down one line space. 
Vy Moves the pen carriage up one line space. 
Fra Moves the pen carriage to the home position. 
= CR Moves the pen carriage to the left margin (and 
generates a ‘- if CR GENERATES LF is 
selected on the Parameter Entry Card). 
we Soa Activates the Alternate Font. (See the SELECT 
ALTERNATE ALPHA FONT command.) 
Sa Activates the Standard Font. (See the SELECT 
} | STANDARD ALPHA FONT command.) 
8For Style-Il command applications only: To obtain the equivalent action in 
Alpha mode, use the sppropriate attention character sequence ("T’ F, Oo, 
A or ATS), Individual Fe, O, or “I characters received in Alpha mode will be 
~ ignored. 
a 
at 
vga 
ae 
a | 
el 
eal 
— 


Table 10-5 
































4663 PROGRAMMER’S REFERENCE 


ALPHA COMMANDS 


References 

Special considerations are necessary to ensure that 
Strings are properly delimited and/or terminated. For 
specific information, see information pertaining to 
strings in Sections 4 and 5. 


Examples 


The samples in the syntax boxes show how to print the 
first seven letters of the alphabet: ABCDEFG. 
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PRINT CENTERED 


Purpose: This command causes ASCII character(s) to be printed and centered about the current pen position. 
After each character is printed, the pen carriage moves back to its original position. 


SERIAL 





At Ap AP string 
Sample:  c AAP *Q” 


print-string 





: 4050 Basic (Data Byte Form) 


PRINT @ pa,32: “AP print-string” ; 
Sample: PRINT @1,32: “AP oO” : 
Parameters Examples 
print-string or string The samples in the syntax boxes cause the uppercase uy 
Represents one (or more) ASCII characters: letter ‘‘O” to be printed and centered about the current 
e Sp through ®. (Control characters are ignored) pen position. 


Comments 


The PRINT CENTERED command is often used for 
labeling points on a graph. Characters should be 
limited to uppercase letters and other full-width sym- 
bols that have the same center as a typical uppercase 
letter. See the top portion of Figure 10-10. Two or more 
characters may be combined to form a new symbol (for 
example, the characters “N” and “Z” can be used to 
form an X with a box around it as shown in the bottom 
portion of Figure 10-10). As a recommendation, use the 
default selection for the ALPHA SPACING CONTROL 
command when using the PRINT CENTERED com- 
mand. 


Pen position 
before and after 
PRINT CENTERED 
command 


Pen position 
References before and after 


PRINT CENTERED 


Special considerations are necessary to ensure that 
command 


print strings are properly delimited and terminated. For 
specific information, see the topics pertaining to 
strings in Sections 4 and 5. 


ae 
= 





Figure 10-10. PRINT CENTERED Command. 
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MOVE TO HOME 


Purpose: This command moves the pen carriage to the home position (a point located one character below the 
upper-left corner of the Viewport along a line perpendicular to the current printing direction). 


SERIAL 





AT Ap AH 


Sample: co A AH 


GPIB 


4050 Basic (Data Byte Form) 


PRINT @pa,32: “H” 
Sample: PRINT @1,32: “H” 


' 4050 BASIC (Secondary Address Form) 


PRINT @pa,23: 
Sample: PRINT @1,23: 


4050 BASIC (Special Keyword Form) 
HOME @pal,23]): 
or 
PAGE @pal,22]: 
Samples: HOME @1: 
or 
PAGE @1: 
Comments Examples 
This command does not cause a Plotter media change The samples in the syntax boxes show how to move the 
action. pen carriage to the home position. 
For a Page keyword shown in the last syntax box, the 
Plotter substitutes a Move-To-Home action. 
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CHARACTER MOVE 


Purpose: This command causes the pen carriage to move the specified number of character spaces (right) and 


line spaces (up). 


SERIAL 





AT Ap AM 
Ec AAM 


Sample: 


GPIB 
AM 


= 4050 Basic (Data Byte Form) 


PRINT @ pa,32: “AM”; 
Sample: PRINT@ 1,32: “AM”; 


o> SONS ese rare z TES 2s SS Ss 


Parameters 


character-spaces 
Number of character spaces to move right 


line-spaces 
Number of line spaces to move up 


Comments 


Negative parameter values reverse the direction of the 
move. When margin control is active and the CHARAC- 
TER MOVE command moves the pen carriage to the 
right of the right margin, the Plotter automatically 
follows this command with a PRINT ©r “er command. 
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character-spaces,line-spaces 
3,2 


character-spaces;line-spaces 
3;2 


References 


Margin control is discussed at the front of this section 
and under the SET MARGIN SEPARATION command. 


Examples 
The samples in the syntax boxes show how to move the 


pen carriage to the right three character spaces and up 
two line spaces from the current position. 
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GRAPHICS COMMANDS 


CONCEPTS 


The Graphics commands described in this section fall 
into the following categories: 


® Selection and setup commands. 
@ Line type selection commands. 


® Commands that reposition the pen carriage or draw 
lines. 


@ Acommand for reporting a setup. 
@ Commands for plotting arcs and circles. 


GRAPHICS SELECTION AND SETUP 
COMMANDS 


While many set-up and selection options exist, the 
initial state of the Plotter when powered up makes the 
Plotter appear as a terminal screen when operating 
with a Serial interface and as a 4050 Series screen 
when operating with a GPIB interface. 


Initial states were discussed in Section 1; Table 11-1 
summarizes the initial states for the selection and set- 
up commands in this section. The table includes the 
command names, the choices available, and the initial 
power-up or default state. 


Typically these setup and selection commands are 
modified to match the application. For example: 


@ SELECT DEVICE UNITS command can be changed 
to millimeters (mm). 

@ SET VIEWPORT command can be set to match a 
desired plot size. 


@ SET WINDOW command can be set to match the 
user’s World Coordinates. 


In addition, some applications require Graphic Units to 
be selected as Device Units or the SELECT CLIPPING 
CONTROL selection may need to be changed to Page. 
Other selections are more dependent on the subject 
matter of the plot and can be changed during a pilot. 
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Table 11-1 
GRAPHICS SELECTION AND SETUP COMMANDS 

















Command Name Choices Default State 

— + 

SELECT GRAPHIC !World, Device World 

UNITS = 

SELECT DEVICE ADUs, GDUs, mm | ADUs for Serial inter- 


UNITS face, GDUs for GPIB 


interface 





SET VIEWPORT Available using 
front panel, com- 
mand setting, or 


Parameter Entry 


Initial Aspect Ratio 
selection on 
Parameter Entry Card 











Card 
+ —- 
SET WINDOW Available using Rules for ranges 
command settings | described in 
Section 1 
= =| 
SELECT PEN Crosshair Cursor, | Pen 1 
Pen 1, Pen 2 
SELECT “[nteotuta, Relative |Abeciite 


COORDINATE TYPE 








SELECT CLIPPING |Viewport, Page Viewport 
CONTROL 

ral | 
SELECT LINE Solid, fixed dash- | Solid 
TYPE pattern-length, 


variable dash- 
pattern-length 
point 
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LINE TYPE SELECTION COMMANDS 


These commands select graphic line types: 


@ SELECT LINE TYPE 
@ SET DASH PATTERN 
@ SET DASH PATTERN LENGTH 


Each command is discussed here. 


SELECT LINE TYPE Command 


Four graphic line types are available and are illustrated 
in Figure 11-1. They include solid, fixed dash-pattern- 
length, variable dash-pattern-length, and point. 


Typically these set-up and selection commands are 
modified to match the application. For example: 


@ SELECT DEVICE UNITS command can be changed 
to millimeters (mm). 


@ SET VIEWPORT command can be set to match a 
desired plot size. 


@ SET WINDOW command can be set to match the 
user’s World Coordinates. 


In addition, some applications require Graphic Units to 
be selected as Device Units or the SELECT CLIPPING 
CONTROL selection may need to be changed to Page. 
Other selections are more dependent on the subject 
matter of the plot and can be changed during a plot. 


Solid is the default line type selection that occurs at 
power-up and after the DEVICE RESET command. 
Certain operations always use the solid line type. 
These operations include: MARK VIEWPORT, OUTLINE 
VIEWPORT, AXIS, and PRINT alphanumeric characters. 


The point line type selection causes a point (dot) at the 
end point of each line drawn. 


The other two line type selections, fixed and variable 
dash-pattern-length, cause dashed and/or dotted lines 
when used with the SET DASH PATTERN and SET 
DASH PATTERN LENGTH commands. When fixed 
dash-pattern-length is selected, a given pattern begins 
at the start of the first line and is repeated as often as 
necessary to complete the line. Any portion of the 
pattern that is not used in the first line is used in the 
next connected line. This process continues for each 
successive connected line. If necessary, the pattern 
bends around corners. Unlike the variable dash-pat- 
tern-length line type, the fixed dash-pattern-length line 
type uses a constant (fixed) pattern length. The pattern 
is started or restarted again after a MOVE command or 
any SELECT LINE TYPE, SET DASH PATTERN, or SET 
DASH PATTERN LENGTH command. 


The variable dash-pattern-length line type automatical- 
ly reduces the pattern length (if necessary) so that the 
smallest whole number (one or more) of patterns fits 
along the line drawn. For each DRAW command, the 
reduced pattern length may be different. 


If Option 31 is installed on your Plotter, you can use all 
four line types for drawing arcs and circles. The most 
useful line types are solid and fixed dash-pattern- 
length. The other two types create patterns using the 
actual chords of the arc or circle as a sequence of 
curved line segments. 
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END OF 
SECOND DRAW 


END OF 
FIRST DRAW 


fixed dash-pattern-length 


PATTERN 


variable dash-pattern-length 


SECOND 
POINT 


PATTERN 


FIRST POINT 


3806-50 





Figure 11-1. Four Line Types Shown Using Two Successive Draws. 
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SET DASH PATTERN Command 


For both fixed and variable dash-pattern-length line 
types, the SET DASH PATTERN command establishes 
the dash/dot pattern. This pattern is specified by 1 to 
20 pattern elements consisting of integers from 0 to 
255. Each number represents a relative length of an 
element on the pattern. This means that the length of 
each element relative to the pattern is the numeric 
value of that number element divided by the sum of the 
numeric value of all of the number elements in the 
pattern. The actual pattern length is set using the SET 
DASH PATTERN LENGTH command described later. 


ONE PATTERN 


The rules for setting pattern elements are as follows: 


1. The first element is a DRAW. 

2. Pattern elements are alternately DRAWs and 
MOVEs. 

3. If the first entry is 0, the DRAW is ignored and the 
pattern begins with the next element, which is 
identified as a MOVE. 

4. If Ois assigned to a DRAW element (other than the 
first element), that element will be drawn as a point. 

5. lf Ois assigned to a MOVE element, the two 
adjacent DRAWs will touch. 


Figure 11-2 illustrates these rules. Note that the bottom 
pattern contains three successive 0 elements to pro- 
duce a dot at the beginning. 


3806-51 





Figure 11-2. Sample Dash Patterns. 
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SET DASH PATTERN LENGTH Command 


This command sets the fixed and the maximum dash 
pattern length for dash-pattern-length line types. The 
length is always specified in Initial World Units along 
the X-axis, even though Window settings may cause 
the actual World Units to be different. The actual 
physical pattern length tracks X-coordinate Page size 
and Viewport changes. 


Extremely short pattern lengths (including the default 
length of 0) cause solid lines to be produced with 
DRAW commands. The default length of 0 is in effect at 
power-up and after the DEVICE RESET command. 


PEN CARRIAGE POSITIONING AND LINE 
DRAWING COMMANDS 


The MOVE and DRAW commands are commonly used 
to position the pen carriage and to draw lines. The 
commands listed below perform additional special 
operations: 

@ MOVE TO LOAD POINT 

@ OUTLINE VIEWPORT 

@ MARK VIEWPORT 

® 


AXIS 


A SETUP REPORTING COMMAND 


The READ VIEWPORT command reports the 
coordinates of the Viewport and can be useful when 
setting a new Window to match the existing Viewport 
aspect ratio. 


ARCS AND CIRCLES (REQUIRES 
OPTION 31) 


With Option 31 installed, the following three additional 
Graphics commands are available: 

@ DRAW ARC 

@ DRAW CIRCLE 

@ SET ARC SMOOTHNESS 


The main characteristics of these commands are 
discussed here. 


The Plotter can draw approximations of arcs and 
circles using a series of straight lines that form chords. 
The accuracy of these approximations is adjustable 
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using a programmable smoothness parameter in the 
SET ARC SMOOTHNESS command. 


Keep in mind the following characteristics: 


@ DRAW ARC and DRAW CIRCLE commands are 
designed to work only with the Graphic Units 
selection set to World Units (and not Device Units). 


@ Transforms affect arcs and circles just as they 
affect characters and lines. Thus, arcs and circles 
can be translated, scaled, rotated, and skewed. 


@ You can use different line types (solid, fixed and 
variable dash-pattern-length, and point) with these 
commands. 


e@ Arguments for arcs are interpreted as absolute 
coordinates even if relative coordinates are selected 
for MOVE and DRAW commands. 


DRAW ARC Command 


Three points specify the arc in the DRAW ARC 
command. The first point is the current position, while 
the intermediate and end points are provided by 
arguments for the command. If the end point and first 
point are the same, a circle is drawn that has a 
diameter defined by the first and intermediate points. 


DRAW CIRCLE Command 


The DRAW CIRCLE command draws a circle at the 
current position with a radius specified by a command 
argument. Upon completion, the pen carriage returns to 
the center of the drawn circle. 


SET ARC SMOOTHNESS Command 


The SET ARC SMOOTHNESS command allows you to 
adjust the visual appearance of arcs, circles, and 
alphanumeric characters with curved components. The 
smoothest approximations to curves have many 
chords, but take much longer to draw than the coarser 
approximations. 


The minimum chord length is determined by internal 
parameters related to the physical precision of the 
Plotter. This occurs when the smoothness factor is set 
to 0. Use coarse approximations for previewing and 
prototyping purposes. However, no chord subtends an 
angle greater than 45°. This limitation occurs when the 
smoothness factor is set to 1, or occasionally a higher 
value for large curves. To retain the same visual 
appearance of smoothness, curves with larger radii 
must have more chords in their approximation. 


GRAPHICS COMMANDS 


The default smoothness of 0.5 provides acceptably specified. In some cases, however, internal numerical 
smooth curves for most applications. However, the limitations of the Plotter may cause an arc with a very 
smoothness setting over the O to 1 range as related to large radius to be plotted instead of a straight line. 


visual smoothness is very nonlinear, especially from 
0.5 to 1 and beyond. Figure 11-3 shows arcs drawn 
with smoothness settings from 0 to 1. The differences 
between 0 and 0.5 settings are more distinguishable 
when the radii are larger. 


Because smoothness is related to physical lengths, the > 
actual number of chords is a function of Page, 


Viewport, and Window selections. A first order adjust- 
ment is made when the physical! World Unit lengths are 
different in the X and Y directions. However, adjust- 
ments are not made for transformations such as 
scaling and skewing 


/ / 
Figure 11-4 shows how the arcs are approximated by a oy / / / 


number of equal length chords. Note that the selected 
intermediate point does not necessarily lie on a chord 
endpoint. 3806-52 


When three points of an arc lie on a straight line (and Figure 11-3. Arcs With Different Smoothness Settings. 
the first and last are not the same as ina circle), a line 
is drawn from the first point to the last point that was 


INTERMEDIATE POINT 
(x-mid, y-mid) 


Re EQUAL LENGTH CHORDS 
DRAWN BY PLOTTER TO 
APPROXIMATE DESIRED ARC. 
RADIUS 


MAXIMUM ANGLE 
IS 45° 


ARC CENTER 


STARTING POINT END POINT 
(PRESENT PEN POSITION) (FINAL PEN POSITION) 
(x-end, y-end) 
(2670)3806-49 


Figure 11-4. An Arc Approximated by Chords. 


11-6 4663 PROGRAMMER’S REFERENCE 








wy 


GRAPHICS COMMANDS 


- 
— 

| COMMAND DESCRIPTIONS 
There are 20 commands described in this section: @ MOVE 

- @ SELECT GRAPHIC UNITS @ DRAW 
@ SELECT DEVICE UNITS @ MOVE TO LOAD POINT 
@ SET VIEWPORT @ OUTLINE VIEWPORT 

= 
@ SET WINDOW @ MARK VIEWPORT 
@ SELECT PEN @ AXIS 

- @ SELECT COORDINATE TYPE @ READ VIEWPORT 
@ SELECT CLIPPING CONTROL @ SET ARC SMOOTHNESS 
@ SELECT LINE TYPE @ DRAW ARC 

= @ SET DASH PATTERN @ DRAW CIRCLE 

i @ SET DASH PATTERN LENGTH These commands are described in the following pages. 

- 

- 

so 

aw 

-” 

- 

- 

- 

a 

- 

—_ 
—? 
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SELECT GRAPHIC UNITS 


Purpose: This command selects the Graphic Units (Device or World Units) for plotting (Moves and Draws) and for 


digitizing (sometimes referred to as graphic input). 


SERIAL 





At Ap BW 
Sample: cA BW 





input-selector[,output-selector] 
0,0 


input-selector[,output-selector] 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BW”; 
Sample: PRINT @1,32: “BW”; 


Parameters 


input-selector 
Graphic Units for Moves and Draws selector, 0-1: 
® O= for World Units 
@ 1 = for Device Units 


oOutput-selector 
Graphic Units for digitizing selector, 0-1: 
@ O= for World Units 
@ 1 = for Device Units 
Omitted means same as input selector 


Comments 


Both the input-selector and output-selector parameters 
default to World Units under the following conditions: 


@ At Plotter power-up 
e@ After a DEVICE RESET command 


input-selector[;output-selector] 
1;1 


Examples 


The samples shown in the syntax boxes illustrate how 
to set input and output selections to World Units for 
Serial applications and to Device Units for 4050 BASIC 
applications. 


The SERIAL san'ple: can be shortened to: 
Ec ABWO 


The 4050 BASIC (Data Byte Form) sample can be 
shortened to: 


PRINT @1,32: “BW”; 1 


Input and output selectors can be different. For 
example: 


Ec A BW O,1 
PRINT @1,32: “BW”; 1,0 
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GRAPHICS COMMANDS 


Purpose: This command allows you to select three types of Device Units: ADUs, GDUs, or mm. 


SERIAL 





AT Ap BV 


Sample: FcABV 





device-units-selector 
1 


device-units-selector 





4050 BASIC (Data Byte Form). 


PRINT @pa,32: “BV”; 


Sample: PRINT @1,32: “BV”; 


Parameters 


device-units-selector 
Device Units selector, 0-2: 


@e O0= ADUs 

e {= GDUs 

@ 2=mm 
Comments 


The default Device Unit selection depends upon the 
active interface. ADUs are the default for Serial appli- 
cations, while GDUs are the default for GPIB applica- 
tions. The Plotter automatically sets to the default 
under these conditions: 


@ Upon power-up 
e@ After a DEVICE RESET command 


@ After the SELECT COMMAND/RESPONSE FORMAT 
command 


@ After the INTERFACE PARAMETER RESET com- 
mand 
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device-units-selector 
0 


Examples 


The Serial applications sample sets Device Units to 
GDUs (from a possible ADU default setting). The 4050 
BASIC (Data Byte Form) sample sets Device Units to 
ADUs (from a possible GDU default setting). Examples 
below set the Device Units to mm: 


Ec A BV 2 
PRINT @ 1,32: “BV”; 2 
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SET VIEWPORT 


Purpose: This command sets the Viewport. 


SERIAL 





AT An AV 


Sample: FcAAV 


\x,urx,lly,ury 
1000,3000,500,2500 


Ilx,urx,lly,ury 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AV”; 


Sample: PRINT @1,32: “AV”; 


Parameters 


IIx 
X-coordinate of the lower-left corner of the Viewport, 
in Device Units 


urx 
X-coordinate of the upper-right corner of the 
Viewport, in Device Units 


lly 
Y-coordinate of the lower-left corner of the Viewport, 
in Device Units 


ury 
Y-coordinate of the upper-right corner of the 
Viewport, in Device Units 


Comments 


An Initial Viewport is established at power-up, after a 
DEVICE RESET command (0, 1, or 3), or by makinga 
selection on any of the following Parameter Entry Card 
lines: 

@ Media Form 


@ Initial Page Size 
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(Ix;urx;lly;ury 
20;120;0;100 


@ Initial Page Format 

@ Page Orientation 

@ Initial Aspect Ratio 

The following restrictions apply to the SET VIEWPORT 
command: 

@ The command resets all transform parameters. 


@ The command does not affect Window coordinates, 
but may change the aspect ratio. 


@ Viewport lengths and widths must always be a 
nonzero value and both corners of the Viewport must 
lie on or in the current Page. 


Errors 


Error 4A 
(Viewport of 0 length or outside Page boundary) For 
0 length Viewports, the upper-right coordinate(s) is 
made slightly larger than the lower-left coordi- 
nate(s). Viewport coordinates outside Page bounda- 
ries are set to the closest boundary. 
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SET WINDOW 


Purpose: This command sets the Window. 


SERIAL 





AT Ap AW 


Sample: FcAAW 


GRAPHICS COMMANDS 





lix,urx,lly,ury 
0,1,0,1 


IIlx,urx,lly,ury 





4050 BASIC (Data Byte Form) 
PRINT @pa,32: “AW”; 


Sample: PRINT @1,32: “AW”; 
Parameters 
IIx 
X-coordinate of the lower-left corner of the Window, 
in World Units 
urx 
X-coordinate of the upper-right corner of the Win- 
dow, in World Units 
Ily 
Y-coordinate of the lower-left corner of the Window, 
in World Units. 
ury 
Y-coordinate of the upper-right corner of the 
Window, in World Units. 
Comments 


An Initial Window is established at power-up, after a 
DEVICE RESET command (0, 1, or 3), or by making a 
selection on any of the following lines of the Parameter 
Entry Card: 

@ Media Form 


@ Initial Page Size 
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Iix;urx;lly;ury 
0;1;0;1 


@ Initial Page Format 

® Page Orientation 

@ Initial Aspect Ratio 

An Initial Window is reset to mm after making a Device 
Units selection of millimeters. (The DEVICE RESET 
command establishes the default Device Units: ADUs 


when the Serial interface is active and GDUs when the 
GPIB interface is active.) 


The following restrictions are associated with the SET 
WINDOW commana: 


@ Changing Window coordinates does not affect the 
Viewport. 
@ All Transforms are reset. 


@ Zero-length and/or mirrored Windows are not al- 
lowed 


Errors 


Error 4B 
(Window less than or equal to 0) The upper-right 
coordinate(s) is set to a value slightly larger than the 
lower-left coordinate(s). 
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SELECT PEN 


Purpose: The SELECT PEN command selects Pen 1, Pen 2, or the crosshair cursor. Selection of the crosshair 
cursor disables the active pen while the crosshair cursor is active. 


SERIAL 


At Ap BP 
Sample: cA BP 


» 4050 BASIC (Data Byte Form): 


PRINT @ pa,32: “BP”; 
Sample: PRINT@1,32: “BP”; 


4050 BASIC (Secondary Address Form)< 


PRINT @ pa,8: 
Sample: PRINT@1,8: 


Parameters 


pen-selector 
Pen-selector, 0 to 255: 


@ O= crosshair cursor 

@ 1= Pen 1 (closest pen to the Plotter front panel) 
@ 2= Pen2 

® 3-255 = no change in the current pen selection 
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pen-selector 
2 


pen-selector 


pen-selector 
2 


pen-selector 
2 


Comments 





A pen selection of ‘‘O” activates the crosshair cursor. 
(Normally, there can be a half-second time-out from the 
last Draw to when the crosshair cursor is selected.) A 
“O” selection temporarily disables the previous pen 
selection while the crosshair cursor is active. Subse- 
quent Draws reactivate the selected pen and deacti- 
vate the crosshair cursor. 


Default selection (Pen 1) is activated after any of the 


following operations: 


@ Powering up the Plotter. 
@ Doing a DEVICE RESET command. 
@ Performing a front panel Initialize function. 
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4 
SELECT COORDINATE TYPE 
Purpose: This command selects either absolute or relative coordinates for Moves and Draws. 
SERIAL 
At Ap BO coordinate-type-selector 
Sample: fcABO 1 
coordinate-type-selector 
»4050 BASIC (Data Byte Form) 
PRINT @ pa,32: “BO”; coordinate-type-selector 
Sample: PRINT @1,32: “BO”; 1 
Parameters Comments 
coordinate-type-selector The Plotter defaults to absolute coordinates under the 
— Coordinate type selector, 0-1: following conditions: 
@ 0 = absolute coordinates 
© 1= relative coordinates @ Upon Plotter power-up 


@ After a DEVICE RESET command 


NOTE 


Only MOVE and DRAW commands can be used 
with relative coordinates. All other graphic com- 
mands require absolute coordinates. 
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SELECT CLIPPING CONTROL 


Purpose: This command selects the clipping boundary for subsequent plotting. 


SERIAL 


AT Ay AK selector 
Sample: §c A AK 1 


selector 





= 4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “AK”; selector 
Sample: PRINT @1,32: “AK”; 1 
Parameters Comments 
selector The default selection is 0. If a portion of the Viewport or 
Clipping selector, 0-1: Page lies outside the platen clipping boundary, clipping 
@ O= Viewport boundary occurs at the platen clipping boundary. 


@ 1 = Page boundary 
Examples 


Figure 11-5 shows clipping on the Viewport and Page 
boundaries. 


yore BOUNDARY ye BOUNDARY 
oe ae 


\ 


= 
= 




















PAGE BOUNDARY 





VIEWPORT CLIPPING PAGE CLIPPING 3806-53 


Figure 11-5. Clipping Viewport and Page Boundaries. — 
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Purpose: The SELECT LINE TYPE command selects the type of line (solid, fixed dash-pattern-length, variable 


- 
wy 
le SELECT LINE TYPE 
_ 
for this command. 
— SERIAL 
AT Ap BL 
Sample: FcABL 
 ] 
a 
a 4050 BASIS (Data Byte Form) 
PRINT @pa,32: “BL”; 
Sample: PRINT @1,32: “BL”; 
om 


bY / parameters 


line-type-selector 
Line type selector, 0-3: 
0 = solid 
@ 1 = fixed dash-pattern-length 
@® 2= variable dash-pattern-length 
® 3= point 
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dash-pattern-length, or point) to be used when drawing lines, arcs, or circles. Note that the line type selection 
applies only when World Units is selected. For Device Units, the line type is always solid, regardless of the selection 


line-type-selector 
1 


line-type-selector 





line-type-selector 
1 


Comments 

Solid is the default line type selection (which occurs at 
power-up and after the DEVICE RESET command). 
Reference 


Refer to Graphics Concepts, earlier in this section, for 
additional information about line types. 
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SET DASH PATTERN 


Purpose: The SET DASH PATTERN command establishes an alternating pattern consisting of up to 20 dots, 
dashes, and spaces to be used when the fixed or variable dash-pattern-length line types are selected. 


SERIAL 





At Ap BD 


Sample: fcABD 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BD”; 


Sample: PRINT @1,32: “BD”; 


Parameters 
pattern-element 

Pattern element, integer, sign ignored, 0-255 
Comments 


The dash pattern consists of 1 to 20 pattern elements 
ranging in value from O to 255. 


References 


Refer to Concepts, earlier in this section, for further 
discussion on dash patterns. 
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pattern-element|,pattern-element!] ... 
2,3 


pattern-elementl[,pattern-element] ... 


pattern-element[;pattern-element] . .. 
2;5;0;2;1 


Errors 


Error 44 
(Integer Outside Legal Range) Pattern-elements are 
replaced by 255. 


Error 45 
(Too Many Entries or String Too Long) This error is 
reported when more than 20 entries are entered. All 
extra entries are ignored. 
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va 
— 
SET DASH PATTERN LENGTH 
Purpose: This command sets the dash pattern length for fixed dash-pattern-length line types and sets the 
= maximum dash pattern length for variable dash-pattern-length line types. 
SERIAL 
a AT Ap BS pattern-length 
Sample: fc ABS 100 
vm 
pattern-length 
a 
.4050 BASIC (Data Byte Form) 
in PRINT @ pa,32: “BS”; pattern-length 
Sample: PRINT @1,32: “BS”; 10 
_ 
Parameters References 
ar “we pattern-length Refer to Concepts, earlier in this section, for further 
Dash pattern length, sign ignored, in Initial World discussion of dash pattern length. 
Units defined along the X-axis 
— 


Comments 


The default length is O at power-up, and after DEVICE 
— RESET commands. Extremely short pattern lengths 
(including 0) produce solid lines. 
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MOVE 


Purpose: This command causes the pen carriage to move (with pen up) to the specified position. 


SERIAL 


At An X x-value,y-vaiue 
Sample: fcAX 1000,2000 


x-value,y-value 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “M”: x-value,y-value 
Sample: PRINT@1,32: “M”; 50;100 


4050 BASIC (Secondary Address Form) 


PRINT@ pa,21: x-value;y-value 
Sample: PRINT@ 1,21: 50;100 


4050 BASIC (Special Keyword Form) 


MOVE @pal,21]: x-value,y-value 
or 
RMOVE @pal,21]: x-relative-value,y-relative-value 
Samples: MOVE @1: 50,100 
or 
RMOVE @1: 10,—10 
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Parameters 


x-value 
X-coordinate 


y-value 
Y-coordinate 


x-relative-value 
Relative X-coordinate 


y-relative-value 
Relative Y-coordinate 


Comments 


The Graphic Units (Device or World Units) selection, 
the Device Units (ADUs, GDUs, or mm), the coordinate 
type (absolute or relative), and current Window all 
affect the MOVE command. 


All Moves to points outside the current clipping limits 
will be clipped and the pen will remain at the clipping 
limit intercept point. A command to move outside the 
clipping limits causes the appropriate off-scale status 
bits in the Device Status word to be set and the lower- 


left and upper-right front panel lights to turn on. 
i ow pp g p g 
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The 4050 BASIC Special Keyword forms MOVE and 
RMOVE are special cases. Moves generated by these 
commands are clipped at the 4050 Window. Coordi- 
nates sent by these commands are sent in GDUs and 
are absolute (even if generated by RMOVE). If the 
coordinate type is set to relative on the Plotter, then 
these absolute coordinates are interpreted as relative 
coordinates; for example, they might be interpreted as 
a displacement from the current position. So, care 
should be taken when using these commands. 


All non-Keyword forms of the MOVE command have 
their data transmitted as entered and without transfor- 
mations or clipping by the 4050 Series controller. 


Examples 


The Special Keyword Form of MOVE assumes that the 
4050 Series Window and Viewport are numerically 
equal in range. The RMOVE sample causes a displace- 
ment of 10,—10 from the current 4050 Series position. 
The new 4050 Series coordinates are transmitted to 
the Plotter. 
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DRAW 


Purpose: The DRAW command causes the Plotter to draw with the active pen from the current position to the 
specified position. 


SERIAL 





AT AD Y x-value,y-valuel,x-value,y-value] ... 
Sample: FecAY 1000,2000 


x-value,y-valuel[,x-value,y-value] ... 





4050 BASIC (Data Byte Form): 


PRINT @ pa,32: “D”; x-value;y-value[;x-value;y-value] ... 
Sample: PRINT @1,32: “D”; 50;100 


4050 BASIC (Secondary Address Form) 
PRINT @ pa,20: x-value;y-valuel;x-value;y-value] . .. 


Sample: PRINT @1,20: 50;100 


4050 BASIC (Special Keyword Form) 


DRAW @ pal, 20]: x-value,y-value 
or 
RDRAW @ pal, 20]: x-relative-value, y-relative-value 
Samples: DRAW @1: 50,100 
or 
RDRAW @ 1: 10,-—10 
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Ww 


Parameters 


x-value 
X-coordinate 


y-value 
Y-coordinate 


x-relative-value 
Relative X-coordinate 


y-relative-value 
Relative Y-coordinate 


Comments 


The Graphic Units selection (Device or World Units), 
the Device Units (ADUs, GDUs, or mms), the coordinate 
type (absolute or relative), and current Window all 
affect the DRAW command. 


All draws to points outside of the current clipping limits 
are clipped and the pen remains at the clipping limit 
intercept point. A command to draw outside the 
clipping limits causes the appropriate off scale status 
bits in the Device Status word to be set and the lower 
left and upper right front panel lights to turn on. 
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The 4050 BASIC Keyword Forms (DRAW and RDRAW) 
are special cases. Draws generated by these com- 
mands are clipped at the 4050 Window. Coordinates 
sent by these commands are sent in GDUs and are 
absolute (even if generated by RDRAW). If the coordi- 
nate type is set to relative on the Plotter, these absolute 
coordinates are interpreted as relative coordinates; for 
example, they might be interpreted as a displacement 
from the current position. So, care should be taken 
when using these commands. 


All non-Keyword forms of the DRAW command have 
their data transmitted as entered without transforma- 
tions or clipping by the 4050 Series controller. 


Examples 


The Special Keyword Form of DRAW assumes that the 
4050 Series Window and Viewport are numerically 
equal in range. The RDRAW form causes a 
displacement of 10,—10 from the current 4050 Series 
position, and the new 4050 Series coordinates are 
transmitted to the Plotter. 
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MOVE TO LOAD POINT 


Purpose: This command causes the Plotter’s pen carriage to move to the upper-right corner of the platen clipping 
boundary (the same point is used for media change operations). 


SERIAL 





At Ap Al 


Sample: cA Al 


GPIB 
Al 


4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “Al” 
Sample: PRINT@1,32: “Al” 


Comments 


The load point usually is outside the Page boundary. If 
so, the Lower Left and Upper Right lights on the front 
panel are on, and the appropropiate off-scale bits in the 
status word are set. 
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OUTLINE VIEWPORT 


Purpose: This command causes the Plotter to draw the Viewport boundary. 


SERIAL 





AT Ap CB 


Sample: *c ACB 


GPIB 
CB 


4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “CB” 
Sample: PRINT @1,32: “CB” 


Comments 


Upon completion of this function, the pen carriage 
“qs returns to its original position. This command is 
identical to the front panel’s Outline Viewport function. 
The outline is clipped for any portion of the Viewport 
that extends beyond the platen clipping boundary. 
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MARK VIEWPORT 


Purpose: This command causes the Plotter to mark the four corners of the Viewport boundary with small 90° 
corner brackets. 


SERIAL 





At Ap CM 


Sample: Fc ACM 


GPIB 
CM 


»4050 BASIC (Data Byte Form) 


PRINT © pa,32: “CM” 
Sample: PRINT@1,32: “CM” 


Comments The actual size of the corner marks depends upon the 
size of the Viewport or Page, but not on the Window 

Upon completion of this command, the pen carriage values. 

returns to its original position. This command is 

identical to selecting the front pane! Mark Viewport With some Viewport reversal situations, the corner 

function. Corner marks that extend beyond the marks extend outward and, therefore, are not visible if 

platen clipping boundary are clipped. the clipping control is set to the Viewport boundary. In 


this case, dots are plotted at the Viewport corners. 
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Purpose: This command causes the Plotter to draw two lines parallel to the current axes with the specified tic 


marks on each line. 


SERIAL 





AtTAD CA 


Sample: FecACA 





x-space,y-spacel,x-intercept,y-intercept] 
100,100,1000,1000 


x-space,y-spacel,x-intercept,y-intercept] 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “CA”; 


Sample: PRINT @1,32: “CA”; 


Parameters 


x-space 
Spacing between tic marks on the X-axis, non- 
negative, O means no tic marks 


y-space 
Spacing bstween tic marks on the Y-axis, non- 
negative, O means no tic marks 


x-intercept 
X-coordinate of axis intersection 


y-intercept 
Y-coordinate of axis intersection 


Comments 


The parameters are specified in World Units. The 
default intercept values are 0 if x-intercept and y- 
intercept are omitted. The actual size of the tic marks 
depends upon the size of the Viewport or Page and 
does not vary with Window values. 
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x-Space;y-space|[;x-intercept;y-intercept] 
10;10 


Errors 


Error 44 
(Integer Outside Legal Range) This error occurs if 
negative values are entered for x-space or y-space. 


Examples 


A command showing an axis at 0,0 with no tic marks on 
the Y-axis and spacings of 10 on the X-axis is: 


PRINT @1,32: “CA”; 10;0 


An axis with the intercept at 4000,3000 and no tic 
marks is: 


Ec ACA 0,0,4000,3000 
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READ VIEWPORT 


Purpose: This command causes the Plotter to report the locations of the lower-left and upper-right corners, 
respectively, of the Viewport. Coordinates are specified in Device Units. 
SERIAL 


(Command/Response Formats 1-2 Only) 
(Two Output Message Blocks Produced) 


Ar Ap CV 
Sample: Fc ACV 


(Two Output Message Blocks Produced) 
CV 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “CV” 

INPUT @ pa,32: first-value-1 -target-variable, 
first-value-2-target-variable, 
first-tag-value-target-variable 

INPUT © pa,32: last-value-1 -target-variable, 
last-value-2-target-variable, 
last-tag-value-target-variable 


Sample: PRINT @1,32: “Cv” 


























INPUT @ 1,32: V1,V2,T1 
INPUT @ 1,32: V3,V4,T2 
Outputs Table 11-2 
First output message block: TAG VALUES FOR READ VIEWPORT COMMAND 
value 7 
X-coordinate of lower-left corner TAG Value By Format 
value 2 ; : a) 
X-coordinate of upper-right corner TAG Meaning Serial Formats | GPIB Formats 
tag value 1 2 1 Thru 6 
See Table 11-2 = 
First Block 2 0 ie) 
Last output message block: 
value 1 Last Block 4 2 2 
Y-coordinate of lower-left corner 
value 2 
Y-coordinate of upper-right corner References 
tag value 
See Table 11-2 See the Serial Interface and GPIB Interface sections 


(Sections 4 and 5) for information about decoding 
output responses from the Plotter. 


11-26 4663 PROGRAMMER’S REFERENCE 


xs 


nd 


~~ 





GRAPHICS COMMANDS 


SET ARC SMOOTHNESS 


Purpose: This command sets the smoothness (or granularity) of arcs and circles, including those used for 
enhanced character quality and Print actions. 


SERIAL 





At Ap BA smoothness 
Sample: FcABA 2 


smoothness 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “BA”; smoothness 
Sample: PRINT@1,32: “BA”; 8 
Parameters 0.5 Asetting used for default setups. 
smoothness 1 A very coarse setting; usually the coarsest avail- 
smoothness value, 0-1, sign ignored able setting. 
>1 The same as a setting of 1” unless the limiting 
Comments case in coarseness has not been reached. 
Ths pea oe he epg bar no eee ehors The defaults setting of 0.5 occurs after power-up and 
are used to approximate an arc or a circle. with the DEVICE RESET commanas. 


The smoothness value is interpreted as follows: 


0 The smoothest setting, which causes the Plotter References 


to draw arcs and circles using the maximum 


UME BFERBTAS. Refer to Arcs and Circles, earlier in this section. 
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DRAW ARC 


Purpose: This command causes the Plotter to draw an arc, which is defined by three points: the current pen 


carriage position and two specified points. 


SERIAL 





AT An AA 


Sample: "cAAA 


x-mid,y-mid,x-end,y-end 


500,500,1000,0 


x-mid,y-mid,x-end,y-end 





4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “AA”; 


Sample: PRINT @1,32: “AA”; 


Parameters 


x-mid 
X-coordinate of intermediate point, in World Units 


y-mid 
Y-coordinate of intermediate point, in World Units 


x-end 
X-coordinate of end point, in World Units 


y-end 
Y-coordinate of end point, in World Units 


Comments 


This command requires Option 31. The current pen 
carriage position provides the first X and Y coordinates 
(the starting point of the arc). The Graphic Units 
selection must be World Units. 


The coarseness of the arc is dependent upon the SET 
ARC SMOOTHNESS command. For maximum preci- 
sion, the intermediate point should be near the mid- 
point of the arc. 


If the end-point is coincident with the first point 
(current pen carriage position), a circle with its 
diameter defined by the first and intermediate point is 
drawn. 
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x-mid;y-mid;x-end;y-end 
50;50;0;0 


If three points are in a line, or if the midpoint coincides 
with either of the end points, the DRAW ARC command 
draws a Straight line from the first point to the end 
point. In some cases, due to numerical resolution, an 
arc with a very large radius is drawn between the 
points specified. 


References 


Refer to the SET ARC SMOOTHNESS command to 
change coarseness of the plotted arcs. 


Examples 


In the Serial sample, if the current pen carriage 
position is at 0,0, then an arc is drawn from that point 
clockwise through 500,500 and ending at 1000,0. 


In the 4050 BASIC sample, if the current position is at 
0,0, then a circle is drawn such that 0,0 and 50,50 lie 

on its diameter. If the current position is 0,100, then a 
straight line between 0,100 and 100,0 is drawn. If the 
current position is 100,100, then a counterclockwise 

arc is drawn. 
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DRAW CIRCLE 


Purpose: This command causes the Plotter to draw a circle centered at the current pen position, and with the 
specified radius. 


SERIAL 





At Ap AC radius|,radius] ... 
Sample: c AAC 1000 


radius[L,radius] ... 





»4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AC”; radiusl[;radius] ... 
Sample: PRINT @1,32: “AC”; 30 
Parameters Examples 
radius Two “target” patterns are generated below: 
Radius of circle, in World Units 

Ec A AC 100,200,300,400,500,600,700, 
800,900,1000 

Comments 


PRINT @1,32: “AC”; 10;20;30;40;50;60; 
This command requires Option 31. The Graphic Units 70;80;90;100 
selection must be World Units. 


Both the DRAW CIRCLE command and the DRAW ARC 
command can draw circles. However, the DRAW CIR- 
CLE command has the following advantages: 


@ |t requires only one argument (radius). 


@ The pen carriage returns to the center of the circle 
after the circle is drawn (rather than remaining at 
the end-point). 


@ This command accepts multiple arguments, which 
thereby specify concentric circles. 
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Section 12 


TRANSFORM COMMANDS 


CONCEPTS 


Transform routines (actually, matrix operations) cause 
the Plotter to modify incoming data. Six transform 
commands are provided to perform specific transform 
operations (e.g., scaling). Transforms are combined 
with existing Viewport and Window settings and other 
transforms to produce a transform matrix designated 
as the current transform. (Page parameters are handled 
separately, so that front panel Set Page adjustments 
can be made without affecting the Viewport, Window, 
and transforms.) The current transform is used to 
convert incoming data into Plotter coordinates, and the 
inverse of this current transform is used for digitizing 
operations. 


The current transform can be modified by subsequent 
transform commands to form a new current transform. 
At any stage, the current transform can be saved (ona 
transform stack) so that it can be restored for later use. 
Two commands to do this are discussed later. 


Transform commands are applicable only when the 
Graphic Units selection is World Units. When using 
Device Units, all transforms and Viewport and Window 
settings are bypassed. 
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TRANSFORMATION OF DATA 


The following transform commands cause incoming 

data to be modified by the specified operation. All of 

these commands assume that the Viewport and Win- 
dow have been established. 


SET SCALE Command 


Incoming X- and Y-coordinates are independently 
multiplied by the dimensionless X- and Y-scale factors. 
Negative scale factors are allowed. 


SET TRANSLATION Command 


X- and Y-coordinate translation values are added to 
the incoming X- and Y-coordinates. This operation has 
the effect of shifting the location of the origin (0,0 
location) by the translation values. 


SET ROTATION Command 


A rotation operation (multiplication by a rotation matrix) 
is performed on the incoming X- and Y-coordinates so 
that the data appears rotated by the specified angle. 
The positive direction of rotation is counterclockwise. 
Rotations occur about the data origin. 
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SET SKEW Command 


The coordinate system can be skewed in the manner 
shown in Figure 12-1. The arrows indicate positive 
skew angles. While the general case allows X- and Y- 
skew angles to be entered together, most applications 
(e.g., to slant a picture) involve entering only one angle 
at a time. The SET SKEW command is defined for 
angles given in all four quadrants such that the picture 
will be reflected about the appropriate axis for angles 
in the 90° to 270° range. 


SET ORIGIN TO CURRENT POSITION 
Command 


The origin is set at the current pen carriage position by 
the process of identifying the current position and then 
doing a translation. 


Both x-skew-angle and 
y-skew-angle are used. 


x-skew- 
angle 





x-skew-angle only 
(y-skew-angle = 0) 


SET ROTATION TO LAST ANGLE 
Command 


In this operation, a Set Origin To Current Position 
operation is performed followed by a rotation operation 
so that the new X-axis is in the same direction as the 
last MOVE or DRAW command (or, with Option 31, the 
last chord of the DRAW ARC command). The origin is at 
the current pen carriage position. This routine is useful 
for printing alphanumeric characters or other symbols 
along the same axis of a previously drawn line. 


y-skew-angle only 
(x-skew-angle = 0) 


y-skew- 
angle 





Figure 12-1. Conventions for the SET SKEW Command. 
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COMBINING TRANSFORMS 


The order in which the transforms are entered is 
important. The convention adapted in the Plotter is one 
of reverse ordering — the last transform received is the 
first one to act on the incoming data. Figures 12-2 and 
12-3 illustrate how the order that transforms are 
entered affect the picture. The steps in Figure 12-2 
show how a square is transformed by commands 
entered in this order: 


1. SET ROTATION (angle = 45°) 
2. SET SCALE (x-scale = 2, y-scale = 1) 


STARTING FIGURE 





TRANSFORM COMMANDS 


Figure 12-3 illustrates the results of entering the same 
commands, but in the opposite order: 


1. SET SCALE (x-scale = 2, y-scale = 1) 
2. SET ROTATION (angle = 45°) 


Note that the Plotter applies commands in the opposite 
order in which you enter them. 


THEN ROTATION 


Figure 12-2. Scale and Rotation. 
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STARTING FIGURE ROTATION THEN SCALE 


3806-56 





Figure 12-3. Rotation and Scale. 
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SAVING AND RESTORING TRANSFORMS 


The SAVE CURRENT TRANSFORM and RESTORE 
PREVIOUS TRANSFORM commands allow current 
transforms to be saved on a transform stack and 
recalled later. The stack is cleared along with any 
transform associated with the current transforms when 
a new SET WINDOW or SET VIEWPORT operation is 
performed. These operations can be either commands, 
front panel operations, or a result of Paramater Entry 
Card operations. Also, the DEVICE RESET command 
clears all transforms associated with the current 
transform and clears the transform stack. 


The SAVE CURRENT TRANSFORM command is used 
to save, on the transform stack, the current transform 
and any previously saved transforms. 


TRANSFORM COMMANDS 


The RESTORE PREVIOUS TRANSFORM command is 
used to remove the last transform saved on the 
transform stack and to restore it as the current 
transform. The next previously saved transform is 
available to be restored at the next RESTORE PREVI- 
OUS TRANSFORM operation. So the stack operates on 
a last-in, first-out basis. 


One application of the save and restore operations 
involves labeling vectors along the vector axis. The 
procedure involves these steps: 


1. Draw the vector 

2. Issue the SAVE CURRENT TRANSFORM command 

3. Issue the SET ROTATION TO LAST ANGLE 
command 

4. Label the vector 

5. Issue the RESTORE PREVIOUS TRANSFORM 
command 

6. Continue plotting 


COMMAND DESCRIPTIONS 


There are eight commands described in this section: 


SET SCALE 

SET TRANSLATION 
SET SKEW 

SET ROTATION 
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@ SET ORIGIN TO CURRENT POSITION 
@ SET ROTATION TO LAST ANGLE 

@ SAVE CURRENT TRANSFORM 

@ RESTORE PREVIOUS TRANSFORM 


Each command is described separately in the pages 
that follow. 
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SET SCALE 


Purpose: This command multiplies the plot data by the specified scale factors. 


SERIAL 





At Ap AS x-scale,y-scale 
Sample: c AAS —1,2.5 


x-scale,y-scale 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AS”; x-scale;y-scale 
Sample: PRINT@1,32: “AS”; —1;2.5 
Parameters Comments 
x-scale Negative scale factors are allowed. 
X-coordinate scale factor (nonzero) 
y-scale Errors 


Y-coordinate scale factor (nonzero) 
Error 49 


(Scale = 0) The Plotter sets a very small positive 
scale factor. 
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SET TRANSLATION 


Purpose: This command translates plot data by specified translation values. 


SERIAL 





AT Ap AT x-translation,y-translation 
Sample: Fc AAT 20,0 


x-translation,y-translation 





= 4050 BASIC (Data Byte Form) === <— 


PRINT @pa,32: “AT”; x-translation;y-translation 
Sample: PRINT @1,32: “AT”; 20;0 


| 


Parameters 


x-translation 
ww Translation distance in X direction 


y-translation 
Translation distance in Y direction 
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SET SKEW 


Purpose: This command skews plot data for either or both axes. 


SERIAL 
At An AQ 


Sample: FcAAQ 


4050 BASIC (Data Byte Form): 


PRINT @pa,32: “AQ”; 


Sample: PRINT @1,32: “AQ”; 


Parameters 


x-skew-angle 
The clockwise angle between the old and new Y- 
axes, in degrees 


y-skew-angle 
The counterclockwise angle between the old and 
new X-axes, in degrees 


Comments 


This command can change the plotted lengths of units 
on the skewed axes. 


Angles from 89.9° to 90.1° and from 269.9° to 270.1° 
are converted to 89.9°. 


This command is defined for angles given in all four 
quadrants such that the picture will be reflected about 


the appropriate axis for angles in the 90° to 270° range. 
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x-skew-angle,y-skew-angle 
15,15 


x-skew-angle,y-skew-angle 





x-skew-angle;y-skew-angle 
15;15 


Reference 


Angle direction conventions for the SET SKEW com- 
mand are described under Concepts at the beginning 
of this section. 


Errors 


Combinations of x-skew-angle and y-skew-angle that 
add up to 90° or 270° are not allowed. Such 
combinations may produce errors in subsequent oper- 
ations as a result of transforming the incoming data 
onto a line. 
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SET ROTATION 


Purpose: This command rotates plot data about the origin. 


SERIAL 





At Ap AR 


Sample:  c AAR 


GPIB 
AR angle 


4050 BASIC (Data Byte Form) « 


PRINT @pa,32: “AR” angle 
Sample: PRINT @1,32: “AR” 30 
Parameters 
angle 
— Rotation angle, in a counterclockwise direction, in 
degrees 
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SET ORIGIN TO CURRENT POSITION 


Purpose: This command sets the origin (0,0) to the current pen carriage position. 


SERIAL 
At An AO 


Sample: *c AAO 





GPIB 
AO 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AO” 
Sample: PRINT @ 1,32: “AO” 
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SET ROTATION TO LAST ANGLE 


Purpose: This command sets the origin (0,0) to the current pen carriage position and then rotates the new system 
about its origin so that the new X-axis is in the direction of the most recent motion (MOVE or DRAW) command (or, 
with Option 31, the last chord of the DRAW ARC command). 


SERIAL 





AT Ap AL 


Sample: Fc AAL 


GPIB 
AL 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AL” 
Sample: PRINT @1,32: “AL” 
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SAVE CURRENT TRANSFORM 


Purpose: This command saves the current transform so that it can be restored for later use. 


SERIAL 
At Ap AX 


Sample: *cAAX 





GPIB 
AX 


4050 BASIC (Data Byte Form) : 


PRINT @pa,32: “AX” 
Sample: PRINT @1,32: “AX” 


Comments References 
This command saves the current transform by pushing See the RESTORE PREVIOUS TRANSFORM command. 
it onto a last-in, first-out transform stack for retrieval by ad 
the RESTORE PREVIOUS TRANSFORM command. 
Errors 
i f 
Each transform saved requires 30 bytes of RAM rar te 


storage. The current transform remains in effect. ; 
(Transform stack overflow or underflow) Memory is 


insufficient to store the current transform. 
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w 
RESTORE PREVIOUS TRANSFORM 


Purpose: This command restores a transform previously saved by the SAVE CURRENT TRANSFORM command. 


SERIAL 





AT AD AY 


Sample: FcAAY 


GPIB 
AY 


4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “AY” 
Sample: PRINT @1,32: “AY” 


Comments References 

This command replaces the current active transform See SAVE CURRENT TRANSFORM command. 
‘ww’ -with the transform most recently saved by the SAVE 

CURRENT TRANSFORM command. Errors 

Recalling the saved transform frees the Plotter memory Error 82 


Lbs hy tte PrBRiaus Giy’E CURRENT Thanh ORM (Transform stack underflow or overflow) No trans- 


DEnIMare, forms are currently stored in the transform stack, 
and the current transform is not changed. 
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Section 13 


DIGITIZING COMMANDS 


INTRODUCTION 


The Plotter’s digitizing commands permit the host 


computer to request and obtain coordinates of: (1) the 
current pen position, or, (2) of points designated by the 


operator by front panel POINT switch functions. Cur- 
rent pen position information is obtained using the 
DIGITIZE command. 


Operator designated points are obtained using the 
Operator Digitize Set-up and Action commands dis- 
cussed below for each of the two interfaces. Note that 
POINT switch responses depend on the POINT switch 
mode, which may be disabled, enabled, or permanently 
enabled. 


CONCEPTS 


Five operator digitizing procedures are discussed in 


the following text. Two procedures are for use with the 
Serial interface; three are for use with a GPIB interface. 


The procedures are: 
®@ Operator Digitizing via Serial Interface (Formats 1 
through 4) 


@ Operator Digitizing via Serial Interface (Formats 3 
and 4) 


@ Operator Digitizing via GPIB Interface (Formats 1 
through 6) 


@ Operator Digitizing via GPIB Interface (Formats 5 
and 6) 


®@ Operator Digitizing via GPIB Interface (without SRQ 


Messages) 


OPERATOR DIGITIZING VIA SERIAL 
INTERFACE (FORMATS 1 -4) 


Operator digitizing consists of: (1) enabling or disab- 
ling the front panel POINT switch, (2) controlling the 
front panel Point light, and (3) processing the data 
received from the Plotter for each point. 
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The following summarizes a typical application: 


1. The OPERATOR DIGITIZE ENABLE command is 


used to enable the Plotter’s POINT switch for (in 
this example) twelve points and to turn the Point 
light to a steady on condition. 


2. For each point, the operator uses the Joystick to 


position the crosshair cursor over a desired point 
and then selects either the front panel Move Point 
or Draw Point function. This instructs the Plotter to 
store the point. 


Alternatively, the operator can use the front panel 
Last Point function to indicate the last point (see 
Step 3). 


3. For each point, the Plotter sends one output 


message block of information consisting of X and Y 
position values and a TAG value. The TAG value 
indicates the POINT switch function (Move Point or 
Draw Point) and, for the last point, it indicates the 
last block of data. (If Format 3 or 4 is used, the 
Plotter sends a status block, rather than position 
information for the last point.) 


If this is NOT the last point, go back to Step 2. 
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4. The Plotter turns off the steady POINT light 
indication, and disables the POINT switch. 


This completes the operator digitizing process. Either 
the Plotter operator or the host computer can terminate 
the operator digitizing process after fewer than the 
specified number of points; the operator can use the 
POINT switch Last Point function or the host computer 
can send an OPERATOR DIGITIZE ENABLE command 
with an argument of 0 to disable the POINT switch. The 
Plotter responds in Formats 1 and 2 by sending a final 
one-block output message with a TAG value indicating 
the last block and in Formats 3 and 4 by sending a 
status block. 


For Formats 3 and 4 only, the host computer must 
enable the POINT switch for one more point than 
required. The “last point” response contains status 
rather than position information. 


For special applications, the host computer can also 
use the JOYSTICK AXIS DISABLE command to restrict 
Joystick motion to one axis only, or the PROMPT 
LIGHT ON and PROMPT LIGHT OFF commands to 
signal the operator to take a predefined action. 


OPERATOR DIGITIZING VIA SERIAL 
INTERFACE (FORMATS 3 AND 4 ONLY) 


Operator digitizing, when using Command/Response 
Formats 3 and 4, can be performed as described above 
for Formats 1 through 4 or as described below for the 
permanently enabled POINT switch mode. 


For Command/Response Formats 3 and 4, the POINT 
switch is permanently enabled after power-up or after a 
DEVICE RESET, INTERFACE PARAMETER RESET, or 
SELECT COMMAND/RESPONSE FORMAT command 
(and remains so unless an OPERATOR DIGITIZE 
ENABLE command is received). Thus, the Plotter 
operator must be instructed as to when to use or not 
use the POINT switch. 
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Atypical application is summarized below: 


1. The PROMPT LIGHT ON command is used to flash 
the Point light, which indicates to the Plotter 
operator that digitizing is permitted. 


2. For each point, the operator uses the Joystick to 
position the crosshair cursor over a desired point 
and then selects either the front panel’s Move 
Point or Draw Point function, thus instructing the 
Plotter to store the point. 


Alternatively, the Plotter operator can use the Last 
Point function (which sends a status message) to 
indicate the end of digitizing. This action assumes 
an agreed-upon meaning for the status message. 
The Last Point function does NOT cancel the 
permanently enabled mode, and does not acquire 
point position data. 


3. For each point, the Plotter sends one output 
message block of information consisting of X and Y 
position values and a TAG value. The TAG value 
indicates the POINT switch function (Move Point or 
Draw Point). If a Last Point function is used, the 
Plotter sends a status block rather than position 
information. 


If this is NOT the last point, go back to Step 2. 


4. PROMPT LIGHT OFF command is used to stop the 
flashing Point Light indication, thus informing the 
Plotter operator to stop digitizing (the Point light 
remains lit and the POINT switch is still perman- 
ently enabled). 


This completes the operator digitizing process. 
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OPERATOR DIGITIZING VIA GPIB 
INTERFACE (FORMATS 1-6) 


Operator digitizing involves: (1) enabling or disabling 
the front panel POINT switch (and sometimes the 
Joystick), (2) controlling the front panel Point light, (3) 
requesting data for each point (via the CALL DIGITIZE 
command), and (4) processing the data received from 
the Plotter for each point. 


The operator digitizing operations discussed below 
involve GPIB SRQ messages used to inform the GPIB 
controller that the Plotter has data available. An 
alternate method of operation without SRQ message 
generation is discussed later in this section. 


A typical application for operator digitizing is summar- 
ized below: 


1. The OPERATOR DIGITIZE ENABLE command is 
used to enable the POINT switch for (for example) 
twelve points and to turn the Point light to a steady 
on condition. 


2. For each point, the operator uses the Joystick to 
position the crosshair cursor over a desired point 
and then selects either the front panel Move Point 
or Draw Point function, thus instructing the Plotter 
to store the point. 


Alternatively, the Plotter operator can use the front 
panel Last Point function to store a point and to 
terminate operator digitizing. (Refer to the discus- 
sion below.) 


3. The Plotter sends an SRQ (Status Request) 
message. 


4. For each point, the GPIB controller sends a CALL 
DIGITIZE command to request data. 


5. For each point, the Plotter sends one output 
message block of information consisting of X and Y 
position values and a TAG value. The TAG value 
indicates the POINT switch function (Move Point or 
Draw Point) and indicates for the last point, the last 
block of data. 


If this is NOT the last point, go back to Step 2. 


4663 PROGRAMMER’S REFERENCE 


DIGITIZING COMMANDS 


6. The Plotter turns off the Point light, and disables 
the POINT switch functions. 


This completes the operator digitizing process. The 
sample 4050 program in Figure 13-1 allows the Plotter 
operator to store up to twelve points and displays the 
results on the 4050 display. 


Either the Plotter operator or the GPIB controller can 
terminate the operator digitizing process after fewer 
than the specified number of points. The operator can 
use the POINT switch Last Point function, or the 
controller can send an OPERATOR DIGITIZE ENABLE 
command with an argument of 0 (meaning disable). The 
Plotter responds by sending a one block output 
message with a TAG indicating last block. (If the GPIB 
controller disables the enabled POINT switch, it must 
be able to handle the corresponding one-block output 
and SRQ messages.) 


In general, if (1) either method of disabling the POINT 
switch after fewer than the specified number of points 
is allowed, and (2) Move vs. Draw Point TAG data is 
needed, then the GPIB controller should enable the 
POINT switch for one more than the required number of 
points, and treat the last block of data as control 
information, not point data. (This avoids the limitation 
that the TAG value for a front panel Last Point function 
cannot include Draw Point (vs. Move Point) information; 
the TAG value always indicates Move Point.) 


For special applications, the host computer can use the 
JOYSTICK DISABLE command to restrict Joystick 
motion to one axis only, or the PROMPT LIGHT ON and 
PROMPT LIGHT OFF commands to signal the operator 
to take a predefined action. 
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PROGRAM LISTING 


182 REM Sample GPIB Operator Digitize Program—---—(Point switch "enabled" ) 
118 REM Set GPIB Device Address 

128 D=1 

130 REM Set initial program values for Point count, Tag value 

140 N=1 

158 T= 

160 REM Enable the Plotter’s POINT Switch for 12 points maximum. 

170 PRINT @D,32:"AG";12 

18@ REM Establish SRQ routine for reading points & printing data 

{98 ON SRQ THEN 1000 

208 REM Loop until “last point" is received (i.e. tag value >= 2) 

210 IF T<2 THEN 200 

248 PRINT "“CDONE 1“ 

250 END 

108@ REM Beginning of SRQ service routine- 7 == —— 
{@1@ REM (If more than one GPIB device can generate SRQ messages, 

1820 REM add appropriate statements to handle the other messages. ) 
1830 REM Read one point from plotter 

104@ PRINT @D,32:"C 

{@5Q@ INPUT @D,32:X,Y.T 

1862 REM Print results on 485@ Display 

1070 IF T=1 THEN 1118 

108@ IF T=3 THEN 1110 

1898 A$="MOVE POINT: " 

1198 GO TO 1126 

111@ AS$="DRAW POINT: “ 

112@ PRINT USING 1130:A8;" X="5X%35" Y="3Y3" TAG= 
1138 IMAGE 12A,3A,4D.2D, 3A,4D.2D,6A,2D,13A,2D,A 
1140 N=N+! 

1158 RETURN 

1168 End of SRQ service routine-- 





Stee SCPOTNT (NOL 





PROGRAM EXECUTION 


run 

MOVE 
DRAW 
DRAW 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
DRAW POIN 
CDONE 


wv 
Oo 
ms 
zz 


34444 4 si 


(POINT 
CPOINT 
CPOINT 
(POINT 
(POINT 
CPOINT 
¢POINT 
¢CPOINT 
(POINT 
(POINT 
(POINT 
(POINT 


uv 
oS 
cad 
z 
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Henne Hee 
Cl 0 Re ee pe pe be pe 
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Net Net Pee te te te 8 re 


= p= pee 


32.98 





Figure 13-1. Sample GPIB Operator Digitize Program (Enabled). | 
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OPERATOR DIGITIZING VIA GPIB 
INTERFACE (FORMATS 5 AND 6) 


Operator digitizing, when using Command/Response 
Formats 5 and 6, can be performed as previously 
described for Formats 1-6 or as described in the 
following text for the permanently enabled mode. 


The operator digitizing operations discussed here 
involve GPIB SRQ messages used to inform the GPIB 
Controller that the Plotter has data available. An 
alternate operation without SRQ (Status Request) 


message generation is discussed later in this section. 


For Command/Response Formats 5 and 6, the POINT 


switch is permanently enabled after power-up or after a 


DEVICE RESET or SET COMMAND/RESPONSE 


FORMAT command or after a GPIB INTERFACE CLEAR 


message (and remains so unless an OPERATOR 
DIGITIZE ENABLE command is received). Thus, the 
Plotter operator must be instructed as to when to use 
or not use the POINT switch. 


A typical application is summarized below: 


1. The PROMPT LIGHT ON command is used to flash 


the Point light, indicating to the Plotter operator 
that digitizing is permitted. 


2. For each point, the operator uses the Joystick to 
position the crosshair cursor over a desired point 
and then selects either the front panel’s Move 
Point or Draw Point function, thus instructing the 
Plotter to store the point. 


Alternatively, the Plotter operator can use the Last 
Point function for instructing the Plotter to store a 
point (which produces a last block TAG value) and 


to indicate the end of digitizing. This action as- 


sumes an agreed-upon meaning for the last block 
TAG information. The Last Point function does NOT 


disable the permanently enabled POINT switch. 
3. The Plotter then sends a SRQ message. 


4. For each point, the GPIB controller sends a CALL 
DIGITIZE command to request data. 
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5. For each point, the Plotter sends one output block 
of information consisting of X and Y position values 
and a TAG value. The TAG value indicates the 
POINT switch function (Move Point, Draw Point, or 
Last Point). 


If this is NOT the last point, go back to Step 2. 


6. The PROMPT LIGHT OFF command stops the 
flashing POINT light indication, thus informing the 
Plotter operator to stop digitizing. (The Point light 
remains on steady; the POINT switch is still 
permanently enabled.) 


The sample 4050 program in Figure 13-2 allows the 
Plotter operator to store points and displays the results 
on the 4050 display. 


This completes the operator digitizing process. 


OPERATOR DIGITIZING VIA GPIB 
INTERFACE WITHOUT SRQ MESSAGES 


Operator digitizing via GPIB can be performed without 
the need for or generation of SRQ (Status Request) 
messages. If a CALL DIGITIZE command is sent before 
each POINT switch function is pushed, the Plotter 
responds with data without sending an SRQ message. 


Use the last two operator digitizing procedures with two 
changes: 


@ Step 3 is ignored. 


® Step 4 is performed immediately before Step 2 
(instead of after Step 3). 


NOTE 


If the Plotter operator pushes the next POINT 
switch function before the GPIB controller has 
been able to send the next CALL DIGITIZE 
command, an SRQ message will result. If using a 
TEKTRONIX 4050 Series controller, or any con- 
troller that recognizes SRQ’s, a “do nothing” SRQ 
service routine is required to satisfy the unex- 
pected SRQ’s. 
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PROGRAM LISTING 


{@@ REM Sample GPIB Operator Digitize Program---("permanently enabled" ) 
11@ REM Set GPIB Device Address 
120 D=1 
{38 REM Set initial program values for Point count, Tag value 
140 N=! 
150 T=0 
168 REM Turn ON the “Prompt light" (flashing Point |ight indication) 
1706 PRINT @D, 32:"T";1 
{80 REM Establish SRQ routine for reading points & printing data 
198 ON SRQ THEN 19082 
2088 REM Loop until “last point" is received 
IF T<2 THEN 286 
REM Turn OFF the “Prompt light" (flashing Point light indication) 
PRINT @D,32:"T";@0 
PRINT “CDONE J" 
END 
REM Beginning of SRQ service routine 
REM (If more than one GPIB device can generate SRQ messages, 
REM add appropriate statements to handle the other messages. ) 
REM Read one point from plotter 
PRINT @D,32:"C" 
INPUT @D,32:X,Y,T 
REM Print results on 4@5@ Display 
IF T=t THEN 1110 
IF T=3 THEN 1112 
A$="MOVE POINT: " 
GO TO 1128 
A$="DRAW POINT: " 
PRINT ‘USING 1130cAGs" X="5X%s" Ye"evg" TAGS"sTs” CPROINT NO. SNe? >" 
IMAGE 12A,3A,4D.2D,3A,4D.2D,6A,2D,13A,2D,A 
N=N+ 
RETURN 





End of SRQ service routine 


PROGRAM EXECUTION 


rut 
MOVE 
DRAW 
DRAW 
DRAW 
DRAW POI 
DRAW POIN 
MOVE POIN 
CDONEI 


X= 
X= 
X= 
K= 
X= 
X= 
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rt at bat be 
ZeZzZzzZ 


T 
T 
T 
T 
T 
T 
T 
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3806-58 





Figure 13-2. Sample GPIB Operator Digitize Program (Permanently Enabled). = 
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COMMAND DESCRIPTIONS 


There are six commands described in this section: 
@ DIGITIZE 
@ OPERATOR DIGITIZE ENABLE 


@ CALL DIGITIZE 
@ PROMPT LIGHT ON 
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@ PROMPT LIGHT OFF 
@ JOYSTICK AXIS DISABLE 


Each command is described separately in the pages 
that follow. 
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DIGITIZE 


Purpose: This command causes the Plotter to send one output message block containing current X and Y 
position values and a TAG value. Position values are expressed in current Graphic Units. 


(One Output Message Block Produced) 


At Ap M 
EcAM 


(One Output Message Block Produced) 
G 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “G” 
INPUT @pa,32: 


Samples: PRINT @1,32: “G” 
INPUT @1,32: 


4050 BASIC (Secondary Address Form): 


PRINT @pa,24: 
INPUT @ pa,32: 


or 
INPUT @pa,24: 


Sample: PRINT @1,24: 
INPUT @1,32: 

or 
INPUT @1,24: 


4050 BASIC (Special Keyword Form). 
GIN @pal, 24]: 


Sample: GIN @1: 


13-8 





value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 


V1,V2,T 


value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 


value-1 -target-variable, 


value-2-target-variable, 
tag-value-target-variable 


V1,V2,T 


V1,V2,T 


value-1-target-variable, 
value-2-target-variable 


V1,V2 
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Outputs 
value 1 
X- position 


value 2 
Y- position 


tag value 
See Table 13-1 


Table 13-1 
TAG VALUES FOR DIGITIZE COMMAND 








TAG Value 
TAG Serial GPIB 
Meaning Formats: Formats: 

















1 | 2 | 3-41/1-4| 5-6 
— 
PEN UP ee ah oe! ae 
PENDOWN | 5 | 3 as 1 
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References 


See either the Serial Interface or GPIB Interface 
section (Section 4 or 5) for information on decoding 
output responses from the Plotter. 


Examples 


The samples in the syntax boxes show how to obtain 
the current pen position values and TAG value. Note 
that for the GIN Keyword, only two target variables are 
allowed; the TAG value is ignored. 
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OPERATOR DIGITIZE ENABLE 


Purpose: This command enables the front pane! POINT switch for a specified number of points. (A value of 0 


“disables” the POINT Switch.) 


SERIAL 


(One Output Message Block Per Point) 


At Ap AG 
Sample: -cAAG 


4050 BASIC (Data Byte Form): 


PRINT @pa,32: “AG”; 
Sample: PRINT @1,32: “AG”; 


Parameters 


number-of-points 
Number of points, 0-65535. Specia! values: 





























@ 65535 = infinity 
eo = disabled 
Table 13-2 
TAG VALUES FOR OPERATOR DIGITIZE 
RESPONSES 
Meaning Assigned to TAG TAG Value for 
POINT Switch | Serial Format: 
Point Switch Enabled Permanently |~—>j——~-~———_- 
Enabled 1 2 3-4 
—— = 
Move Point Move Point 2 | 0 
Draw Point Draw Point Ta 4 =i 
as, _t + —_ 
Move Point, last block 
or Last Point Last Point 4 12 | 28 
or OPERATOR DIGITIZE 
DISABLE 
{_ 
Draw Point, last block ls | 3 

















4Status Block is sent 
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number-of-points 
12 


number-of-points 





number-of-points 
12 


Outputs 


Serial Interface (except Last Point in Com- 
mand/Response Formats 3-4): 


value 1 

X- position 
value 2 

Y- position 


tag value 
Use Table 13-2 


Serial Interface (Last Point in Command/Response 
Formats 3-4): 


value 1 
0 


value 2 
Device status (see Table 9-5 under the READ 
STATUS command in Section 9) 


tag value 
2 
GPIB Interface: 


This command does not request output. Use the CALL 
DIGITIZE command or the abbreviated command 
shown under COMMENTS to request output. Use one 
request per point. 
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Comments 


This command enables the POINT switch for a speci- 
fied number of points. The Plotter operator can then 
locate and store each point using the Joystick and the 
POINT switch, respectively. 


The default POINT switch mode is permanently en- 
abled for Serial Formats 3 and 4 and for GPIB Formats 
5 and 6. Disabled is the default POINT switch mode for 
all other Formats. 


If the POINT switch is enabled and an OPERATOR 
DIGITIZE ENABLE command with O argument (to 
disable the command) is received, the Plotter responds 
as if the front panel Last Point function had been 
selected. If the POINT switch is not enabled, the 
disable is ignored. 


GPIB only: The following abbreviation of the 4050 
BASIC form for the CALL DIGITIZE command (the 
command code is omitted) or the equivalent GPIB 
action can be used to request each output message 
(one per point) after each Point switch action: 


INPUT @1,32: value-1-target-variable, 
value-2-target-variable, 
tag-value-target-variable 

Sample: 
INPUT @1,32: V1,V2,T 


The output values are identical to those described for 
the CALL DIGITIZE command. 
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References 


See either the Serial Interface or GPIB Interface 
sections (Section 4 or 5) for information on decoding 
output responses from the Plotter. 


Examples 


The samples in the syntax boxes enable the POINT 
switch for up to 12 points. Eleven points are enabled 
for Serial Formats 3 and 4 or for any other Format 
where the last block provides control rather than 
position information. 
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CALL DIGITIZE 


Purpose: This command (GPIB only) is used to request position data stored by the front panel POINT switch 
function during operator digitize actions. The Plotter responds to the CALL DIGITIZE command by sending one 
output massage block containing X and Y position values and a TAG value. Position values are expressed in current 
Graphic Units. 





GPIB 
(One Output Message Block is Produced) 
Cc 
= 4050 BASIC (Data Byte For) ———————— arr 
PRINT @pa,32: “C” | 
Hi INPUT @pa,32: value-1-target-variable, 


value-2-target-variable, 
tag-value-target-variable 


Sample: PRINT @1,32: “Cc” 
INPUT @1,32: V1,V2,T 


ee eer zs mores 


ye 4050 BASIC (Secondary Address Form) === 


PRINT @pa,27: 

INPUT @pa,32: value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 

or 

INPUT @pa,27: value-i -target-variable, 
value-2-target-variable, 
tag-value-target-variable 

Samples: PRINT @1,27: 

INPUT @1,32: V1,V2,T 

or 


INPUT @1,27: V1,V2,T 
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Outputs 


value 7 
X- position 


value 2 
Y- position 


tag value 
See Table 13-3 
Table 13-3 


TAG VALUES FOR CALL DIGITIZE COMMAND 


























TAG Meaning 

POINT Switch 

POINT Switch Enabled Permanently TAG 
Enabled Value 

Move Point Move Point | 0 

Draw Point Draw Point tl 

Move Point last biock 

or Last Point Last Point 2 

or OPERATOR DIGITIZE 

DISABLE 

; =a 
Draw Point last block 3 
——— | 
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Comments 


The CALL DIGITIZE command can be used in two ways 
described below. The two methods differ in regard to 
generation and use of GPIB SRQ messages. 


@ The CALL DIGITIZE command is sent after the 
POINT switch is pushed; the Plotter generates an 
SRQ message when the POINT switch is pushea. 
The controller then sends a CALL DIGITIZE com- 
mand to obtain the one-block output message. 


@ The CALL DIGITIZE command is sent before the 
POINT switch is pushed; the Plotter sends a one- 
block output message as soon as data is available. 
No SRQ message is sent. (Note: If the operator is too 
fast and generates another point before the next 
CALL DIGITIZE command, an SRQ message will be 
sent. For controllers that respond to SRQ, a ‘do 
nothing” SRQ service routine may be needed.) 


Format 5 and 6 only: The front panel Last Point 
function generates a last block Move Point inaication. 
This response is NOT avaiiable from the 4662 Plotter; 
the 4662 front panel CALL switch send status 
operation is the nearest function, but generates differ- 
ent output information. 


References 

See Section 5 for information on decoding output 
responses from the Plotter. 

Examples 


The samples in the syntax boxes show how to acquire 
data produced by a POINT switch function. 
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PROMPT LIGHT ON 


Purpose: This command produces a flashing POINT light indication. 


SERIAL 


AT Ap K 


Sample: FcAK 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “T”; 
Sample: PRINT @1,32: “T”; 


4050 BASIC (Secondary Address Form) 


PRINT @ pa,26: 
Sample: PRINT @1,26: 


Parameters 


selector 
Prompt light selector,O-1: 
@ i1=ON 
® O= OFF (see PROMPT LIGHT OFF command) 


Comments 


The flashing POINT light indication set by this com- 
mand is overridden by any subsequent action that will 
set or clear a steady POINT light indication (for 
example, an OPERATOR DIGITIZE ENABLE command 
or a POINT switch function that terminates operator 
digitizing). 


Serial Command/Response Formats 3 and 4 only: The 
Prompt light on state is one of several factors that 
enable prompt string scan action when a prompt string 
is defined. For details, refer to the Communicating with 
Other Devices discussion in Section 4. 


Serial interface only: This command does not have an 
argument. 
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selector 





selector 
1 


selector 
1 


References 
See the PROMPT LIGHT OFF command description. 


Examples 


The samples in the syntax boxes set the Prompt light 
on, as indicated by a flashing POINT light. 
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nd 
PROMPT LIGHT OFF 
Purpose: This command cancels the flashing POINT light indication set by the PROMPT LIGHT ON command. 
SERIAL 
’T Ao iL 
Sample: FeAL 
selector 
4050 BASIC (Data Byte Form): 
PRINT @pa,32: “T”; selector 
Sample: PRINT @1,32: “T”; Oo 
4050 BASIC (Secondary Address Form)= 
PRINT @pa,26: selector 
Sample: PRINT @1,26: (e) 
~~ | , 
Parameters Examples 
selector The samples in the syntax boxes cancel the Prompt 
Prompt light selector, 0-1: light on, and end the flashing POINT light indication. 
@ O= OFF 
e@ 1 = ON (See PROMPT LIGHT ON command) 
Comments 
Refer to PROMPT LIGHT ON command. 
—_ 
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JOYSTICK AXIS DISABLE 


Purpose: This command disables Joystick motion along the axis (or axes) specified. 


SERIAL 


At Ay BJ axis-selector 
Sample: Fc ABJ 1 


axis-selector 





4050 BASIC (Data Byte Form): 


PRINT @pa,32: “BJ”; axis-selector 
Sample: PRINT @1,32: “BJ”; 1 
Parameters Errors 
axis-selector Error 44 
Axis-to-be-disabled selector, 0-3: (Integer Outside Legal Range) The Plotter substi- 
@ O= neither axis tutes a value of “0”. 


@ 1= X-axis 
@ 2= Y-axis 
@ 3= both axes 


Comments 
The disabled axis (or axes) is automatically enabled by 


the next command or front panel action that causes 
pen carriage motion. 
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Section 14 


MACRO COMMANDS 


INTRODUCTION 


The programmable macros (available only with Option 
31) allow the user to store groups of frequently used 

Plotter commands. Each of these groups of commands 
can later be executed by sending an EXPAND MACRO 


command. This capability can be used in many appli- 
cations to reduce the number of commands transmitted 
to the Plotter, thereby reducing plotting time. 


CONCEPTS 


The following general concepts are presented: 
@ Macro fundamentals 
® Restricted commands 


@ Macro storage requirements 


MACRO FUNDAMENTALS 


Macro fundamentals include both an overview of 
programmabie macros and a discussion of the graphics 
environment during macro use. 


Overview of Programmable Macros 


The programmable macro feature allows a group of 
Plotter commands preceded by a BEGIN MACRO 
DEFINITION command and followed by an END MA- 
CRO command to be identified by a macro number and 
saved in the Plotter memory. When the Plotter receives 
an EXPAND MACRO command for a specified macro, 
the Plotter executes the commands defined within the 
macro. A macro can contain EXPAND MACRO com- 
mands, allowing macros to expand other (nested) 
macros. With this capability, complex graphic patterns 
can be generated using only a few simple patterns. 


NOTE 


A macro definition cannot include an EXPAND 
MACRO command that references itself either 
directly or indirectly through any other EXPAND 
MACRO commands. 
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The SET AUTO MACRO command designates a 
specified macro to be automatically expanded at the 
end of each DRAW, DRAW ARC, and DRAW CIRCLE 
command. The macro expansion begins at the end of 
the line or arc, or at the center of the circle. 


The Graphics Environment and Macros 


The commands stored in programmable macros are 
processed, before being stored, according to the 
current Graphic Units, Device Units, and coordinate 
type. If these parameters are subsequently changed 
before the macro is expanded, the macro will retain the 
original parameters. For example, if a macro is defined 
while the coordinate type is set to relative, the Moves 
and Draws within the macro specification will be stored 
as relative Moves and Draws. If the coordinate type is 
changed to absolute and the macro is subsequently 
“expanded,” the Moves and Draws within the macro are 
still executed as relative Moves and Draws. 


Selections on certain Parameter Entry Card lines must 
be the same when the macro is defined and when it is 
expanded. These lines are: Media Form, Initial Page 
Size, Initial Page Format, Page Orientation, and Initial 
Aspect Ratio. 
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RESTRICTED COMMANDS 


Commands from the following command groups will not 
work as expected if included in macro definitions. Do 
not use these commands. 


@ Any of the commands listed in either the Serial or 
GPIB Interface sections (Sections 7 and 8). 


@ Any commands that generate output, including the 
OPERATOR DIGITIZE ENABLE command. 


@ A DEVICE RESET command. 


@ A PROMPT LIGHT ON command or a PROMPT 
LIGHT OFF command. 


@ A SELECT GRAPHIC UNITS command. 
@ A SELECT DEVICE UNITS command. 


@ Any of the commands listed in the Downloadable 
Characters Commands section (Section 15). 


@ A DELETE MACRO command. 
@ ASET AUTO MACRO command. 
@ A READ MACRO STATUS command. 


MACRO STORAGE REQUIREMENTS 


This section describes how to determine the number of 
memory bytes required to store any macros transmitted 
to the Plotter. There are two main topics: 


@ How to determine the number of bytes required to 
store the internal form of the individual commands 
within the macros. 


@ How to determine the number of bytes required to 
store a group of macros (which includes control 
information and the individual macro definition com- 
mands). 


14-2 


Macro Size 


The following describes how to determine the size of a 
specific macro. The macro size is the number of bytes 
required to express the internal form of the individual 
commands within the macros. The total! storage re- 
quired by a macro is larger than the macro size value 
and will be described in the following discussion, 
Macro Storage. 


For macros already transmitted to the Plotter, the READ 
MACRO STATUS command returns the macro size 
value for each current macro. For this case, skip to the 
following discussion (Macro Storage) to determine the 
storage required. Calculate the size of a specific macro 
by adding the bytes required to store the internal form 
of each command in the macro. The bytes required for 
a command can be determined as follows: 


@ Each command requires two bytes plus the bytes 
required to store the command arguments. 


@ A numeric argument requires five bytes. 


@ Astring argument consisting of a single character (a 
character argument) requires one byte. 


@ Commands with string arguments of more than one 
character are divided into multiple commands, each 
with a character argument. 


@ Commands which allow multiple groups of argu- 
ments are divided into one command for each 
argument group. 


Now, after the commands have been divided (if 
required), the size of each command is as follows: 


Command Size = 2 
+ (1) (number of character 
arguments) 
+ (5) (number of numeric 
arguments) 


The macro size is then the sum of the command size 
values for each command in the macro. 
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The BEGIN MACRO DEFINITION and END MACRO 
commands are not included in the macro size calcula- 
tion. Note that the macro size value may be greater 
than or less than the number of characters required to 
transmit the macro to the Plotter.( Refer to /nput 
Buffering in either Section 4 or 5 of this manual for 
additional information about the external and internal 
form of commands.) Some example commands and 
their associated sizes are shown in Table 14-1. 


Table 14-1 


MACRO SIZE EXAMPLES 
































2 
Command Argument Size 
— =I 

OUTLINE VIEWPORT No Argument 
PRINT A 
PRINT ABC Ts 
DRAW ARC 50,50500 | 22 
DRAW CIRCLE 100 7 

———S! 
DRAW CIRCLE 100,200,300 ja 
DRAW 5,10,10,20 24 











Macro Storage 


This section describes how to determine the total 
memory required to store a specific group of macros 
using either the READ STATUS command or a 
prescribed procedure. 


If the macros are already programmed, the actual 
storage used can be determined using the READ 
STATUS command as follows: 


1. Read the Current Available Memory value from the 
Plotter (via the READ STATUS command). 


2. Download the macros. 
3. Repeat Step 1. 


4. Thedifference between the value in Step 1 and the 
value in Step 3 is the memory used to store the 
group of macros. 


NOTE 


The amount of memory reported as allocated for 
macro storage using this procedure will be in 64- 
byte increments as the macros are referenced. 
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A second method to determine macro storage require- 
ments is as follows: The total storage required fora 
group of macros is the sum of the storage required for 
each macro plus the storage required for a directory of 
each of the current macros. (The directory is automati- 
cally maintained.) The method used to determine macro 
size was discussed previously. 


To determine the storage bytes required for each 
macro, an adjusted macro size value is computed by 
adding 19 bytes to the macro size value to account for 
control information storage. If this information is an 
exact multiple of 62, then the adjusted macro size 
value is increased by 62 bytes. Next, the adjusted 
macro size value is multiplied by 1.04 and rounded up 
to the next higher multiple of 64 bytes. The resultant 
value is the number of storage bytes allocated to the 
storage of this macro. (This computation accounts for 
storage in blocks of 64 bytes.) 


Each defined macro has a corresponding entry in the 
macro directory that requires eight bytes of storage. To 
determine the storage bytes required for the directory, 
multiply the number of macros to be defined by eight. If 
this value is an exact multiple of 62, then increase the 
value by 62 bytes. The resultant value is then multi- 
plied by 1.04 and rounded up to the next higher 
multiple of 64 bytes. The resultant value is the number 
of storage bytes allocated to the storage of a macro 
directory of this size. 


The total storage required for a given group of macros, 
then, is the sum of the storage required for each macro 
plus the storage required for the macro directory. 


A standard 4663 with 8K bytes of memory installed has 
about 3700 bytes of memory available for macro 
storage if the Serial interface is active; about 3900 
bytes are available with the GPIB interface active. This 
amount of memory will accomodate approximately 50 
small macros. 


The available memory is also used on a first-come, 
first-served basis for the storage of: 


@ Transforms saved by a SAVE CURRENT 
TRANSFORM command. 


@ The buffering of output responses. 
@ The storage of downloadable characters. 
@ The storage of commands in the input buffer. 
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COMMAND DESCRIPTIONS 
There are six commands described in this section: ® READ MACRO 
@ BEGIN MACRO DEFINITION @ SET AUTO-MACRO 
@ END MACRO DEFINITION Each command is described in turn in the following 
@ EXPAND MACRO pages. 


@ DELETE MACRO 
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w 
BEGIN MACRO DEFINITION 
Purpose: This command begins a macro definition. 


SERIAL 





At Ay BB macro-number 
Sample: cA BB 2 


macro-number 





4050 BASIC (Data Byte Form): 


PRINT @ 1,32: “BB”; macro-number 
Sample: PRINT @1,32: “BB”; 2 
Parameters Errors 
) macro-number The following errors may occur during the macro 
—_ Macro number, 0-255 definition process: 
Error 85 
Comments (Insufficient memory for buffer allocation) Insuffi- 
sie i ists to begi ti t f 
This command begins the definition of the specified sree tas rs plasty bait 
macro. Any previously defined macro with the same ; ; 
number is deleted. The Plotter commands that follow Error 42 
are stored in the specified macro. (Ilegal macro command usage) A restricted com- 
mand is encountered and the macro definition is 
ignored. 
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END MACRO DEFINITION 


Purpose: This command ends the macro definition. 


SERIAL 





At Ap BE 


Sample: cA BE 


GPIB 
BE 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BE” 
Sample: PRINT @1,32: “BE” 


Errors 


Error 85 
(Insufficient memory for buffer allocation) 
Insufficient memory exists and the macro definition 
is deleted. 


14-6 4663 PROGRAMMER’S REFERENCE 


~~ 


MACRO COMMANDS 


EXPAND MACRO 


Purpose: This command causes the Plotter to perform the instructions defined in the specified macro. 


SERIAL 









AT Ap AE macro-number[,macro-number] ... 
Sample: cA AE 0,1,14,22,10,0 


macro-numberl,macro-number] ... 








4050 BASIC (Data Byte Form) SSS SS eS a aE eee 
PRINT @pa,32: “AE”: macro-number[;macro-number] ... 
Sample: PRINT @1,32: “AE”; 0;1;14;22;10;0 
Parameters Errors 
macro-number Error 86 
Macro number, 0-255 (Cannot find specific macro) The command is 
ignored. 
Error 43 


(Macro called itself) The command to call itself is 
ignored, even if called from another macro definition 
within the first macro definition. 
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DELETE MACRO 


Purpose: This command deletes the specified macro or macros from Plotter memory. 


SERIAL 





AT Ap BK 
Sample: cABK 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BK” 
Sample: PRINT @1,32: “BK”; 


Parameters 
macro-number 


Macro number, 0-255, omitted macro number means 
all macros 
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[macro-number[,macro-number] ...] 


[macro-number[,macro-number] .. .] 


[;macro-number[;macro-number] .. .] 


Comments 
If the specified macro is not defined, there is no action. 


When a macro is deleted, the storage used by the 
macro is released for other purposes. 
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READ MACRO STATUS 


Purpose: This command causes the Plotter to report the status of defined macros. 


SERIAL 





(Command/Response Formats 1-2 Only) 
(One Output Message Block Per Macro) 


At An CS 
Ec ACS 


Sample: 


(One Output Message Block Per Macro) 


cS 


MACRO COMMANDS 








4050 BASIC (Data Byte Form) 
PRINT @ pa,32: “CS” 


value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 


INPUT @pa,32: 


Execute one INPUT statement for each output 


NOTE 
message biock. 


Sample: PRINT @1,32: “CS” 
INPUT @1,32: V1,V2,T1 
INPUT @1,32: V3,V4,T2 
INPUT @1,32: V5,V6,T3 
Outputs Table 14-2 


There is one output message block for each macro and 
one when no macro is defined. The values for each 
message block are as follows: 


TAG VALUE BY FORMAT FOR READ MACRO 
STATUS COMMAND 





TAG Value by Format 








value 7 TAG Serial GPIB 
Macro number, range 0-255 Meaning Format: Formats: 


value 2 
Macro size (see COMMENTS) 


tag value 
See Table 14-2 
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Eis 1-6 





Not the Last Block 
Last (or Only) Block 





2 0) 0 
4 2 2 
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Comments 


The Plotter responds to this command with one output 
block for each macro defined. Execute one INPUT 
statement for each output message block until a last 
block TAG is read. The macro size value reported 
indicates the number of bytes required to store the 
internal form of the individual commands included in 
the macro. However, the complete macro requires a 
larger amount of storage, which can be computed using 
the macro size value. Refer to the discussion of macro 
storage requirements earlier in this section for a 
description of how to determine the number of memory 
bytes required to store the complete macro. 
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If no macros are currently defined, the following 
information is sent: 


® value 1 0 
® value 2 0 
® tagvalue For last or only block (see Table 14-1). 


References 


See either Section 4 or 5 for information on decoding 
output responses from the Plotter. 
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SET AUTO MACRO Command 


MACRO COMMANDS 


Purpose: This command designates a specified macro to be automatically expanded at the end of each DRAW, 


DRAW ARC, and DRAW CIRCLE command. 


SERIAL 
At Ap BN 
Sample: fc ABN 


» 4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “BN” 
Sample: PRINT @1,32: “BN”; 


Parameters 


macro-number 
Macro number, 0-255, omitted macro number means 


no auto macro 
Comments 


This macro function is cleared by either the DEVICE 
RESET command or by sending the SET AUTO MACRO 
command with no macro number. 
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[macro-number] 
0 


[macro-number] 





[;macro-number] 
0 


Errors 


Error 86 
(Cannot find specific macro) Auto macro is can- 
celed. 


Error 43 
(Macro called itself) The command to call itself is 
ignored, even if called from another macro definition 
within the first definition. 
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Section 15 


DOWNLOADABLE CHARACTER COMMANDS 


INTRODUCTION 


Downloadable characters (available only with Option 
32) permit special characters and/or symbols to be 
defined (stored in Plotter memory). Once these charac- 
ters have been defined, they can be printed by using all 
the Alpha features available for the resident alpha 
character definitions. These definitions can supercede 
resident character definitions or add definitions not 
currently available. Only the 96 printing ASCII charac- 
ters (Sp through 9.) may be defined. A maximum of 16 
fonts (0 through 15) can be used. 


4663 PROGRAMMER’S REFERENCE 


Along with the ability to define new characters, Option 
32 also provides the user with three predefined fonts 
(Fonts 10, 11, and 15). (These fonts were shown in 
Figures 10-4, 10-5, and 10-6 earlier in this manual.) 
Fonts 10 and 11 contain special mathematical symbols 
and Greek letters. Font 15 contains a single character 
D7 (DEL) defined as a “low resolution” coordinate grid 
usable as a design aid when defining downloadable 
characters. The following paragraphs define the use of 
low resolution coordinates. 
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CONCEPTS 


The following concepts are discussed in this section: 
®@ Defining a Character 

@ Storage Requirements 

@ Printing Downloadable Characters 

@ Option 32 Characters 


SETUP REQUIREMENTS 


The SET GRAPHIC UNITS command and the SET 
COORDINATE TYPE command must be set to default 
arguments while downloading character definitions. 


DEFINING A CHARACTER 


Listed below are the commands to use in defining a 
downloadable character. If a command is required in 
the definition of a specific character, then it must be 
sent in the order indicated here. 

Required: 

e [BEGIN CHARACTER DEFINITION] 

@ [SET CHARACTER X-EXTENT] 

These can be used in any order or combination to 
describe the character: 

@ [MOVE]... 

e [DRAW]... 

e [DRAW ARC]... 

@ [DRAW CIRCLE]... 

@ [SPECIFY NONADVANCING CHARACTER] 


Optional (if next command is BEGIN COMMAND DEFI- 
NITION): 


e@ [END CHARACTER DEFINITION] 


It is legal to terminate one character definition by 
beginning another. 
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Data Ranges for Commands 


The legal range of arguments for the character defining 
commands (MOVE, DRAW, DRAW ARC, and SET 
CHARACTER X-EXTENT) is xmin — 64 through xmin 
+175 in the X direction, and ymin — 64 through ymin 
+175 in the Y direction. For the DRAW CIRCLE 
command, radius values may be as large as 175. 


Downloaded Character Size 


The shaded rectangle in Figure 15-1 illustrates the 
data ranges used to define a typical uppercase charac- 
ter. Alpha size and spacing actions assume that 
characters are defined within the shaded rectangle. 
(Characters can be defined as smaller or larger than 
the shaded rectangle, and will be printed accordingly.) 


For most applications, use the default data ranges, 
shown in parentheses in Figure 15-1. Typical upper- 
case character data ranges are between 0 and 48 for 
the X-axis and between 0 and 88 for the Y-axis. 
Lowercase letters descend to —24 for characters used 
with other resident font characters. Special symbols 
may be larger or smaller, as desired. 


For other applications, use the SET DOWNLOADED 
CHARACTER SIZE command (1) to select different 
data ranges, (2) to utilize an existing character data 
base, (3) to allow more character definition resolution 
(for example, 175 by 175 vs. 48 by 88), or (4) to avoid 
the use of negative values when defining characters 
with descenders. The SET DOWNLOADED CHARAC- 
TER SIZE command sets the ranges for X and Y data. 
The four specified values correspond to the extremes 
of the shaded rectangle in Figure 15-1. Two examples 
illustrate use of this command: 


@ For character data on a O to 6, 0 to 11 grid (for 
typical uppercase characters), use SET DOWN- 
LOADED CHARACTER SIZE values of 0,6,0,1 1. 


®@ To avoid sending negative values for the same 
character data that includes descenders that reach 
—3, add 3 to all Y data after entering SET DOWN- 
LOADED CHARACTER SIZE values of 0,6,3,14. 
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€ 


Available range of values for 
character defining commands 


Region used for a 
typical uppercase 
character 


é 


descender of some 


} Region used for the 
lowercase characters 





Figure 15-1. Numerical Value Ranges for Character Definition Commands. 


o 
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STORAGE REQUIREMENTS 


Described here are ways to determine the number of 
memory bytes required to store downloadable charac- 
ters transmitted to the Plotter. There are two topics 
discussed: 


@ How to determine the number of bytes required to 
store the internal form of the individual commands 
within the downloadable characters. 


@ How to determine the number of storage bytes 
required to store a group of downloadable 
characters. 


Storage Bytes for Each Command Within a 
Character Definition 


The following describes how to determine the number 
of bytes of internal storage for each specific command 
within a downloadable character definition. The total 
storage required for a downloadable character is larger 
(see Determining Total Character Storage). The bytes 
required to store each of the commands used in a 
downloadable character definition are shown in Table 
15-1. 


Table 15-1 


STORAGE BYTES REQUIRED FOR COMMANDS IN 
A CHARACTER DEFINITION 





























= $$ $$ 
High Low 
Command Resolution Resolution 
= cea i 
SET CHARACTER 2 (if right= 48+ xmin) none 
X-EXTENT | 4 (if right 48+ xmin) 
MOVE [3 | 
DRAW i 3 1 
DRAW ARC 5 3 
——- te 
DRAW CIRCLE 2 none 
SPECIFY 1 none 
NONADVANCING 
CHARACTER 











15-4 


If a MOVE, DRAW, or ARC command (within a 
downloaded character definition) has arguments that 
meet both of the following conditions, the command will 
be stored in a low resolution form (commands not 
meeting these conditions are stored in the high resolu- 
tion form): 


@ Arguments are expressed in integer multiples of 
eight from xmin or ymin, 


@ Arguments fall within an X range of xmin to xmin 
+ 48 and a Y range from ymin — 24 to ymin + 96. 
(The xmin and ymin values are the default values of 
O and O, or are specified by the SET DOWNLOADED 
CHARACTER SIZE command.) 


If the command is a SET CHARACTER EXTENT 
command and the right edge is equal to xmin + 48, the 
internal storage requirement is two bytes, otherwise 
four bytes. 


NOTE 


Printing the °t character from Font 15 will drawa 
low resolution coordinate grid, which may be 
used as an aid when defining low resolution 
characters. 


Determining Total Character Storage 


Described here are two ways to determine the total 
memory required to store a specific group of download- 
able characters: 


Measure the amount of current available memory using 
the READ STATUS (1) command, both before and after 
downloading characters. The difference between the 
two readings is the actual storage used for the 
downloaded characters. 


NOTE 


The amount of memory reported as allocated for 

the storage of a downloaded character set using 

this procedure will be in 64-byte increments from 
the value determined by computation. 
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= 
Alternatively, the downloadable character storage re- NOTE 
- ae as described in the Even if downloadable characters are deleted from 
9 PerAgreRns: a font, the deleted character must still be includ- 
The total storage required for a given group of ed in the font storage calculation. The deleted 
= downloaded characters is the sum of the storage character space is not released until the font is 
required for each of the fonts containing characters deleted. 
plus the storage required for the font directory. The storage bytes required for the internal font is 
= First determine the storage bytes required for each aol vee by the etre: of dowaloaded (complete or 
font. Calculate the sum of the storage bytes needed for partial) fonts in use, as follows: 
the individual character-defining commands plus two 64 bytes for O through 7 fonts 
= bytes for each defined character plus 21 bytes. If this 128 bytes for 8 through 15 fonts 
sum is an exact multiple of 62, add 62 (otherwise, use 192 bytes for the 16th font 
the original sum). 
Total storage is the sum of the storage requirements for 
= Then multiply the sum by 1.04 and round the result to the fonts and the font directory. For two examples of 
the next higher multiple of 64. (This computation these procedures, refer to Table 15-2. In the table, 
accounts for the fact that memory is allocated for Case A is based on 46 characters of 100 high 
storage in blocks of 64 bytes.) Repeat this procedure resolution strokes each. Case B is based on 12 
=~ for each additional font. characters of 100 high resolution strokes each. 
—— 
Table 15-2 
DETERMINING TOTAL CHARACTER STORAGE 
— wy —j 
Procedure Case A@ [Case Bb 
1. Strokes ic 100x3 = 2880 12x 100x3 = 3600 
_ Add (2) x (chars) 96 x 2 = 192 12x2 = 24 
Add 21 + 21 + 21 
Subtotal Ne 3093 3645 
2. If not exact multiple (3093+ 62= 49.88 (3645+ 58.79 
- of 62, add 62 ~ integer; thus add 62) + 62 ~ integer; thus add 62) + 62 
Subtotal 3155 3707 
3. Multiply by 1.04 3155 x 1.04 = 3281.2 | 3707 x 1.04 = 3855.28 
= 4. Round upto multiple | 3281 2+ 64= 51.27 3855.28+ 64= 60.24 
of 64 64x 52 = 3328 64x 61 = 3904 
5. Add font direct + 64 + 64 
se (assume < 8 fonts) 
Total 3392 3968 
496 characters of 100 high resolution strokes each 
- Dy 2 characters of 100 high resolution strokes each 
-s 
= 
ww 
a 
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DOWNLOADABLE CHARACTER COMMANDS 


There are about 3700 bytes of memory available on a 
standard 4663 with the Serial interface; with the GPIB 
interface active, there are about 3900 bytes available. 


The available memory is used on a first-come, first- 
served basis in the following order: 
1. The storage of commands in the input buffer. 


2. The storage of downloadable characters. 
3. The storage of programmable macros. 
4. The buffering of output responses. 


5. Transforms saved by a SAVE CURRENT TRANS- 
FORM command. 


This amount of memory accommodates, for example, 
the storage of about: 


®@ 96 coarse characters (with an average of 10 high 
resolution strokes per character in a single font), or 


® about 12 very complex characters (with an average 
of 100 high resolution strokes per character ina 
single font). 


PRINTING DOWNLOADED CHARACTERS 


The following text presents information on printing 
downloadable characters. 


Printed Character Quality 


Downloaded characters and predefined characters in 
Fonts 10, 11, and 15 are not affected by the Alpha 
Character Quality line selection on the Parameter Entry 
Card. Their circles and arcs are, however, subject to 
the control of the SET ARC SMOOTHNESS commana. 


Fonts 10 and 11 Greek and Math character definitions 
exhibit ENHANCED (vs. STANDARD) character quality. 
Downloaded character definitions, when used with 
resident characters, should be defined to match the 
quality of the resident characters that will be selected. 


Priority of Character Definitions 
The plotter identifies each character contained in a 


PRINT command as (1) a downloadable character, 
(2) a character defined in an optional character table, or 
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(3) a character defined in one of the resident character 
tables. When the Plotter receives the character to be 
printed, the entries in these tables, which define the 
specified character in the current active font, are 
searched in a specific order. This order is shown in 
Table 15-3 for a given font n. 


According to Table 15-3, the first definition the Plotter 
encounters is used. This search order establishes a 
priority between the character tables. If a definition for 
the character is not found in any of these tables for 
Font n, then the Plotter uses the resident Font 0 
definition. The redefinition of a Font 0 downloadable 
character does not affect the characters obtained in 
Fonts 1 to 15, which default to the resident Font 0 table 
for their definition. 


Table 15-3 
PRINTING PRIORITIES 











Priority Character Set 

1 (highest) Downloaded Font n character 

2 Resident Option 32 Font n character 
3 Resident Font n character 

4 (lowest) Resident Font 0 character 








For example, if the character A” is defined in Font 14 
via a downloadable character definition (and no other 
downloadable character definitions are present), then 
printing a Font 14 ‘‘A” causes the downloaded 
definition to be used. Printing a Font 14 “B” causes the 
resident Font 0 “B” definition to be used. Printing a 
Font 8 ‘‘A” causes the resident Font 0 “A” to be used. 


OPTION 32 CHARACTERS 


The Option 32 character Fonts 10, 11, and 15 were 
shown previously in Figures 10-4, 10-5, and 10-6. 


NOTE 


When using Font 10 and 117 characters, select 
ENHANCED on the Alpha Character Quality line 
of the Parameter Entry Card. This selection will 
cause the Plotter to draw Font 0 default charac- 
ters with the same quality as that of the Option 32 
characters. 
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DOWNLOADABLE CHARACTER COMMANDS 


COMMAND DESCRIPTIONS 


There are seven commands described in this section: @ SELECT NONADVANCING CHARACTER 

@ SET DOWNLOADED CHARACTER SIZE @ DELETE CHARACTER DEFINITION 

@ BEGIN CHARACTER DEFINITION @ DELETE FONT DEFINTION 

@ END CHARACTER DEFINITION Each command is described separately in the pages 
@ SET CHARACTER X-EXTENT that follow. 
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DOWNLOADABLE CHARACTER COMMANDS 


SET DOWNLOADED CHARACTER SIZE 


Purpose: This command specifies the coordinate ranges to be used when defining a typical uppercase character 
within the specified font. Default ranges are O to 48 (X-axis) and 0 to 88 (Y-axis). 


SERIAL 





At An CZ 


Sample: fcACZ 


font-selector,xmin,xmax,ymin,ymax 
1,0,6,0,11 


font-selector,xmin,xmax,ymin,ymax 





4050 BASIC (Data Byte Form) 


PRINT @pa,32: “CZ”; 


Sample: PRINT @1,32: “CZ”; 


Parameters 


font-selector 
Font selector, 0-15 


xmin 
X-min coordinate, integer 


xmax 
X-max coordinate, integer 


ymin 
Y-min coordinate, integer 


ymax 
Y-max coordinate, integer 


Comments 


This command must be sent before attempting any 
definition of the first character in the font. The 
specifications apply to all character definitions in the 
font. To change the specifications, the font must be 
deleted and redefined. 


The default values of 0,48,0,88 are used for xmin, 
xmax, ymin, and ymax, respectively. 


The arguments of this command describe two aspects 
of following downloadable character definitions for this 
font (refer back to Figure 15-1). 
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font-selector;xmin;xmax;ymin;ymax 
1;0;6;0;11 


First, the xmin and ymin values locate the range of 
integer argument values to be used in subsequent 
definitions. Second, the xmax and ymax values com- 
plete the specifications of the nominal uppercase 
character width (xmax — xmin) and the nominal 
uppercase character height (ymax — ymin). 


The specification of these two aspects allow existing 
character set specifications having unique coordinate 
ranges (for example, 0 to 6, 0 to 11) to be used directly 
as downloadable character specifications. 


If the transmission of negative arguments (as may be 
required for the specification of character descenders) 
to the Plotter is difficult, the character size specifica- 
tions, ymin and ymax, and the character specification 
data may be offset in the positive direction. The offset 
can be the value of the maximum descender coordi- 
nate, thus avoiding the need to specify negative values. 
For example, use O xmin to 6 xmax and 3 ymin to 14 
ymax for the SET DOWNLOADED CHARACTER 
command and add 3 to all Y values for MOVE, DRAW, 
and ARC commands. Descenders in Y will be specified 
from O to 3 rather than from —3 to O. 
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BEGIN CHARACTER DEFINITION 


DOWNLOADABLE CHARACTER COMMANDS 


Purpose: This command begins a downloadable character definition for the specified character in the chosen 


font. 


SERIAL 





At An CN 


Sample: Fc ACN 





font-selector,single-character-string 
13,’a’ 


font-selector,single-character-string 





4050 BASIC (Data Byte Form) : 


PRINT @ pa,32: “CN”: 


Sample: PRINT @1,32: “CN”; 


Parameters 


font-selector 
Font selector, 0-15 


single-character-string 
The character to be defined, Sp through "L, 
noncontrol characters only 


Comments 


This command terminates any current downloadable 
character definition before beginning a new definition. 
If the specified character is defined as a downloadable 
character, the current definition is deleted before the 
new definition is begun. 


Be sure to include the argument separator, shown as a 
comma (,) in the samples. If the argument separator is 
omitted, the command is ignored and no error message 
is produced. 
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font-selector;”,single-character-string”’ 
1 3 ;”,a’ ” 


Errors 


Error 45 
(Too many entries or string too long) First character 
of string is used. 
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DOWNLOADABLE CHARACTER COMMANDS 


END CHARACTER DEFINITION 


Purpose: This command ends the downloadable character definition. 


SERIAL 





At An CO 


Sample: cACO 


GPIB 
co 


4050 BASIC (Data Byte Form) 


PRINT @pa,32: “CO” 
Sample: PRINT@1,32: “CO” 


Comments Errors 
This command is not required if the next command is Error 51 
the BEGIN CHARACTER DEFINITION command. (Illegal downloadable character command) A down- — 


loadable character definition was not in process. 
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DOWNLOADABLE CHARACTER COMMANDS 


SET CHARACTER X-EXTENT 


Purpose: This command specifies the left and right edges of the character. These are used for subsequent 
printing actions whenever the selection for the SELECT ALPHA SPACING CONTROL command is 1 (constant end- 
to-start). 


SERIAL 





AT Ap CT left,right 
Sample: fcACT 10,20 


left,right 





- 4050 BASIC (Data Byte Form) 


PRINT @ pa,32: “CT”; left;right 
Sample: PRINT @1,32: “CT”; 10;20 
Parameters References 
left See the SELECT ALPHA SPACING CONTROL com- 
Left edge X-coordinate mand for a discussion of the use of the character 
extent information in the Alpha Spacing Control func- 
right tion. 


Right edge X-coordinate 


Comments 


The left and right edge coordinates define the actual X- 
axis left and right edges (the actual character extent) 
of a downloadable character. The range of these 
coordinates must be between xmin —64 and xmin 
+175, where xmin has a default value of O or a value 
specified by the SET DOWNLOADABLE CHARACTER 
SIZE command. 
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DOWNLOADABLE CHARACTER COMMANDS 


SELECT NONADVANCING CHARACTER 


Purpose: This command causes the downloadable character being defined to be designated as nonadvancing. 
Subsequent PRINT commands will, after printing a nonadvancing character, move the pen carriage back to the 
original start point for the character. 

SERIAL 


At Ap CU 


Sample: fc ACU 





GPIB 
CU 


4050 BASIC (Data Byte Form) = 


PRINT @ pa,32: “CU” 
Sample: PRINT@1,32: “CU” 


Comments Errors 
When used, this command must be placed at the end of Error 51 
the downloadable character definition. (Illegal downloadable character command) A 
mt downloadable character definition was not in pro- 
In a typical application the composite character n can cess. 


be produced as follows: 
@ First, define ~ as a nonadvancing character. 


® Second, include the nonadvancing ™ character as 
the first of the two-character sequence ~nwithina 
PRINT command. 
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DOWNLOADABLE CHARACTER COMMANDS 


ww 
DELETE CHARACTER DEFINITION 


Purpose: This command deletes a specified character or characters from a specified user-defined font. The 
corresponding memory is not released for other uses. 


SERIAL 





AT Ap CP font-selector,character-string 
Sample:  -c ACP 14,’ABC’ 


font-selector,character-string 





e= 4050 BASIC (Data Byte Form) 


y PRINT @pa,32: “CP”; font-selector;” character-string”’ i 
iN Sample: PRINT @1,32: “CP”; 14;”,/ABC’” i 
Parameters Comments 
“ww = font-selector Be sure to include the argument separator, shown as a 
Font selector, 0-15 comma (,) in the samples. If the argument separator is 
omitted, the command is ignored, but no error message 
character-string is produced. 


One or more characters 
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DOWNLOADABLE CHARACTER COMMANDS 


DELETE FONT DEFINITION 


Purpose: This command deletes all downloadable character definitions for the specified font and releases the 
corresponding memory for other uses. If no font number is specified, a// fonts are deleted. 


SERIAL 
At An CQ [font-selector [,font-selector] .. .] 
Sample: fcACQ 14 


[font-selector[,font-selector] ...] 





4050 BASIC (Data Byte Form) 


PRINT Gagan Ga" [;font-selector[;font-selector] ...] 
Sample: PRINT@1,32: “CQ”; 4 


Parameters 


font-selector 
Font selector, 0-15 


NOTE 
If font-selector is omitted, all fonts are deleted. 
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Section 16 


MEDIA CHANGE COMMANDS 


INTRODUCTION 


Media change operations are discussed in the 4663 
Operator's Manual! in the description of the front panel 
MEDIA switch. The concepts and commands discussed 
here relate to programmable media change operations. 


However, some of the commands set parameters or 
report settings associated with the front panel media 
change functions. 


CONCEPTS 


The media change function works either of two ways, 
depending on the Media Form line setting on the 
Parameter Entry Card. If this line is set to SHEET 
(designated Sheet mode), then commands are pro- 
cessed for media secured by the electrostatic media 
hold-down. If Option 36 (Media Advance) is installed 
and the Media Form line is set to ROLL (designated 
Roll mode), the commands support media change using 
the media drive mechanism. Media changes activated 
by commands for both Sheet and Roll modes do the 
same operations as the MEDIA switch on the front 
panel. 


In Roll mode, the length of media advance is initially set 
to extend 1.25 inches (31.37 mm) beyond the left edge 
of the page. However, the length may also be selected 
by commands in 1/64-inch increments (.897 mm). 
Thus, an advance of 640 will advance the media 10 
inches (254 mm). However, advances less than one 
inch (25.4 mm) may produce an out-of-media indica- 
tion, causing the front panel Plot Control light to blink. 


COMMAND DESCRIPTION 


There are four commands described in this section: 


@ PAGE CHANGE 

@ SET FORM LENGTH 
@ READ FORM LENGTH 
@ ADVANCE MEDIA 
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Each command is described separately in the pages 
that follow. 
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MEDIA CHANGE COMMANDS 


PAGE CHANGE 


Purpose: This command causes a media change operation (in the same manner as the front panel Media Change 


switch) for either Sheet or Roll mode. 


SERIAL 
At Ap BC 
Ec ABC 


Sample: 


GPIB 
BC 


= 4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BC” 
Sample: PRINT @1,32: “BC” 


Comments 


To continue operation when in Sheet mode, press the 
Media Change switch after the media has been 
changed. 

References 


See the Pens and Media section in the 4663 Operator's 
Manual. 
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Examples 


The samples in the syntax boxes show commands that 
initiate the media change operations. In Sheet mode, 
press Media Change on the front panel to continue 
operation after the media has been changed. 


In Roll mode, the complete media advance operation 
will be performed without further intervention. 
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SET FORM LENGTH 


MEDIA CHANGE COMMANDS 


Purpose: This command sets the form length for use either by the PAGE CHANGE command or by the front panel 


Media Change function. 


SERIAL 
AT Ay BF 
Sample: cA BF 





form-length 
768 


form-length 





» 4050 BASIC (Data Byte Form) 


PRINT @pa,32: “BF”; 
Sample: PRINT @1,32: “BF”; 


Parameters 


form-length 
Number of 1/64 inch (.397 mm) increments, non- 
zero, positive values only 


Comments 


The form length is established in positive 1/64-inch 
(.397 mm) increments. In Roll mode, the form length 
specifies the distance that the media is advanced when 
doing a PAGE CHANGE command or when doing a 
front panel Media Change. 
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form-length 
768 


A DEVICE RESET command (0, 1, or 3) or a Parameter 
Entry Card setting on any line from Media Form through 
Initial Aspect Ratio cause the form length to be reset to 
a default value. This default value is the distance from 
the arrow on the media guide to a point 1.25 inches 
(31.37mm) beyond the left edge of the Page. 


Examples 


The samples show how to set a form length of 12 
inches (304.80 mm). 
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MEDIA CHANGE COMMANDS 


READ FORM LENGTH 


Purpose: This command causes the Plotter to respond with a one-block message containing the form length. 


SERIAL 





(Command/Response Formats 1 and 2 Only) 
(One Output Message Block Produced) 


At Ap CF 
Ec ACF 


(One Output Message Block Produced) 


CF 





= 4050 BASIC (Data Byte Form): 


PRINT @pa,32: “CF” 

INPUT @ pa,32: value-1 -target-variable, 
value-2-target-variable, 
tag-value-target-variable 


Sample: PRINT @1,32: “CF” 


INPUT @1,32: V1,V2,T 

Outputs Errors 
value 17 Error 48 

Form length in 1/64 inch (.397 mm) increments (Invalid Command For Selected Output Format) This 

error occurs if Formats 3 or 4 are used with the 

value 2 Serial interface. 

(0) 
tag value Example 


See Table 16-1 
For a form length of 12 inches (304.8 mm), output 











Value-1 is 768. 
Table 16-1 
TAG VALUES FOR READ FORM LENGTH References 
Formats | TAG Values Refer to Section 4 or 5 for information on decoding 
output responses from the Plotter. 
Seria! Format 1 4 
Serial Format 2 2 
GPIB Format 1 Thru 6 | 2 
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ADVANCE MEDIA 


MEDIA CHANGE COMMANDS 


Purpose: This command (used for Roll mode only) causes the media to advance a specified number of 1/64-inch 


(.397 mm) increments. 


SERIAL 
At Ap AU 
Sample: Fc AAU 


:4050 BASIC (Data Byte Form) 


PRINT @pa,32: “AU”; 
Sample: PRINT @1,32: “AU”; 


Parameters 


increments 
Number of 1/64-inch (.397 mm) increments, sign 
ignored 

Comments 


This command requires Option 36. The advance is 
independent of the current form length setting. 
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increments 
128 


increments 





increments 
128 


Errors 


Error 41 
(Illegal Paper Advance Command) Plotter is in Sheet 
mode. 


Examples 


The samples show how to advance the media two 
inches (50.8 mm). 
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Command Format _ L Example Command Format Exampie 
interface Commands Graphics Commands 7 - [ 
BLOCK END Ay Ap) checksum-value EcA)373 AXIS At Ap CA x-space,y-spacel,x-intercept, EcACA100,100,1000,1000 
BLOCK START AT Ap EcA( yeimerceat 
ALA z . 7 is E 
DATA RESET Ar Ay @D EcACD DRAW 1 Ap Y x-value,y-value[.x-value,y-valuel... cAY1000,2000 
A A 7 ‘ a ; a iS = fr os a E 
DEVICE OFF At AD F ECAF DRAW ARC tT ®p AA x-mid,y-mid,x-end,y-~end[,x-mid,y-mid, cAAASOO,500,1000,0 
x-end,y-end]... 
Vv Ar An E E 
DEvIbE tt oe CAE DRAW CIRCLE Ay Ay AC radiusl,radiusl. .. EcAAC1000 
=+ Ae A E 
INTERFACE PARAMETER RESE? TAD CR cACR MARICVIEWBORT Ashe Aa | EcAcM 
=CTC Al NSE FMT Aah format-select EcACC2 ? 
SELECT COMMAND/RESPONSE FM7 t “p CC format-selector cACC MOVE Aphe ¥xvalueyevallid ECAX32,40 
ALA : : i & 
SET BLOCK SIZE tT “p H maximum-block-size cAH132 MOVE TO LOAD POINT Ar A Al ECAAI 
- Ay A : a wake = L 
SET BYPASS CANCEL CHARACTER T “> U bypass-cancel-char-string cAU'r OUTLINE VIEWPORT Ar AD CB ECACB 
: Ar A _stri E “9Sp 
SET PROMPT STRING 7 “D R prompt-string CAR‘ ?°p READ VIEWPORT® Ar Ap GV ECACV 
ALA FP zerar ecebr E, 
SET SIGNATURE CHARACTER T “op S signature-character-string cASA SELECT CLIPPING CONTROL Ap As aie Selector ECAAK1 
SET TURNAROUND DELAY AT Ap G delay-time EcAG200 0: Viewport boundary 
(in milliseconds) 1: Page boundary 
Ben icasuiaands - - SELECT COORDINATE TYPE At Ay BO coordinate-type-selector EcABO1 
0: absolute 
DEVICE RESET Ay Ap N [selector] EcANO 1: relative 
IDENTIFY or SIZE? AT An Q@ EcAQ SELECT DEVICE UNITS AT Ap BV device-units-selector EcABV1 
READ ERROR? Ar AnD CE EcCACE 0: ADU 1: GDU 2:mm 
ALA F 
READ STATUS? Az Ay O status-register-selector EcAO2 SELECT GRAPHIC UNITS T*D BW input-selectorL,output-selector] EcABW1,1 
_ 0: World Units 1: Device Units or -FcABW1 
Alpha Commands (single selector: sets both to same) 
CHARACTER MOVE At Ap AM character-spaces, line-spaces ECAM3,2 SELECT LINE TYPE “rt ’p BL line-type-selector FcABL2 
poy é 0: solid 2: variable dash 
MOVE TO HOME Tp AH cAAH 1: fixed dash 3: end points only 
PRINT AT Ad P string EcAP“ABC”/68‘EFG’ SELECT PEN Ar Ap BP pen-selector | ®cABP2 
PRINT CENTERED At 4p AP string ECAAP“O” 1: Pen 1 0: crosshair cursor (temporarily) | or FcABPO 
: 2: Pen 2 3-255: no action 
RESET ALPHA PARAMETERS AT ADV ECAV 
SET ARC SMOOTHNESS At Ap BA smoothness ECABAO.2 
SELECT ALPHA SPACING CONTROL At Ap AJ spacing-control-selector EcAJ1 (0 to 1, Ois vary smooth, 5 default) 
Q: constant origin-to origin 
1: constant space between characters SET DASH PATTERN Ay Ap BD pattern-elementl,pattern-element]. .. EcABD2,3 
pa i ‘ up to 20 pattern elements: or -cABDO,5,10 
SELECT ALTERNATE ALPHA FONT ‘tT “py BQ alternate-font-selector cABQ8 1st, 3rd, etc. elements: “Draw” or -cABDO,0,0,5,10 
SELECT STANDARD ALPHA FONT Ar 4p T standard-font-selector EcAT1 2nd, 4th, etc. elements: “Move” 
0: “zero Move” if 1st element, 
SET ALPHA DIMENSION Ar Ay | character-space,line-space EcAI90,180 “point” if 3rd, Sth, etc., 
SET ALPHA MARGIN SEPARATION At Ay BR margin-separation EcABR80 “zero Move" if 2nd, 4th, etc. 
(number of spaces) SET DASH PATTERN LENGTH Ar Ap BS pattern-length EcABS100 
SET ALPHA RATIO ‘t Ap BI x-ratio,y-ratio EcABI1.5,1.63636 SET VIEWPORT AT Ap AV Ilx,urx,lly,ury FcAAV1000,3000,500,2500 
SET ALPHA ROTATION AT Ay J rotation-angle EcAJ30 SET WINDOW AT Ap AW Ilxurx,lly,ury ECAAWO,1,0,1 
Ar A 2 7 z 7 E : 
SET ALPHA SCALE T *p BH x-mag-factor,y-mag-factor cABH2,3 Cine Shak meade hee vreduc ed: . 
SET ALPHA SIZE Ar Ap BZ character-width,character-height EcABZ60,110 Stwo output message blocks produced. (continued) 
Cc 
SET ALPHA SLANT Ay Ap BG slant-angle EcABG20 a aaa ae aa 
SET TAB SEPARATION At Ap BT tab-separation EcABTS 
(number of spaces) 
= eee 
3Qne output message block produced. 
Stwo output message blocks produced. 
SOne output message biock per macro. 
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Appendix B 


ASCII CODE CHART 


NOTE 


Two other code charts are presented in this manual: an ASCII encoding chart in the Serial Interface section 
(Section 4), and a GPIB code chart in the GPIB Interface section (Section 5). These charts contain additional, 
interface-dependent information. 





ASCII CODE CHART 












































B6 g 1 1 a 
BS 7 aaa a a | oe gill hg ||eoks 
BITS 
CONTROL NUMBERS | UPPERCASE | LOWERCASE 
B4B3B2B1 SYMBOLS SYMBOLS SYMBOLS 
160 
ooges 
sel70 Pie 
161 
@9ege1 
97/71 q 113 
162 
381 r 
9a|72 114 
163 
9811 s 
99|73 415 
164 
81986 t 
+00| 74 116 
165 
go@18601 u 
101] 75 117 
166 
6118 Vv 
102| 76 118 
167 
g1i11 w 
103] 77 119 
170 
188 BD x 
104| 78 120 
171 
188 1 
105| 79 Lan 
172 
18186 z 
106] 7A 122 
173 
18141 
107| 7B { 123 
1740 
1189 | 
108) 7C 124 
178 
1120981 
403} 70 } 125 
176 
11128 
110| 7E 126 
11441 uiay 
sat] 7E en 07 

















“t 
1 on some keyboards or systems 


KEY 


octal | 25 
NK graphic representation 


nex} 15 NAK 94] gecimal 


mnemonic 


3808-40 


Figure B-1. ASCII Code Chart. 
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Appendix C 


SERIAL INTERFACE CONNECTOR 


Refer to Figure C-1 for the pin/signal name relationships of the RS-232-C Interface connector. 


OOOOO0000000) (COO00O000000 
LOOOO OOO 000 COMBO OOO O0O0O0C0COO,; 


Figure C-1. RS-232-C Interface Connector. 
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Command : Format | Example 2 
Interface Commands 
DATA RESET cD PRINT @1,32. “CD” 
INTERFACE PARAMETER RESET CR PRINT @1,32: “CR” 
SELECT COMMAND/RESPONSE FMT CC format-selector | PRINT @1,32: “CC”; 2 
Device Commands 7 _ 
DEVICE RESET N [selector] PRINT @1,32: “‘N”; O 
no argument: same as O or PRINT@1,32: “‘N” 
IDENTIFY# l PRINT @1,32: “1” 
INPUT @1,32: V1,V2,T 
READ ERROR? CE PRINT @1,32: “CE” 
INPUT @ 1,32: V1,V2,T1 
INPUT @1,32: V3,V4,T2 
READ STATUS? V status-register-selector PRINT @1,32: “Vv”; 2 
INPUT @1,32: V1,V2,T 
Alpha Commands 
CHARACTER MOVE AM character-spaces,line-spaces PRINT @1,32: “AM”; 2;-3 
MOVE TO HOME H PRINT @1,32: ‘H” 
PRINT P print-string PRINT @1,32: “PAbcd” 
PRINT CENTERED AP print-string PRINT @1,32: “APX” 
RESET ALPHA PARAMETERS A PRINT @1,32: “A” 
SELECT ALPHA SPACING CONTROL AJ spacing-control-selector PRINT @1,32: “Ad”; 1 
O: constant origin-to-origin 
1: constant space between chars 
SELECT ALTERNATE ALPHA FONT BQ alternate-font-selector PRINT @1,32: “BQ”; 3 
SELECT STANDARD ALPHA FONT F standard-font-selector PRINT @1,32: “F”; 2 
SET ALPHA DIMENSION S character-space,line-space | PRINT @1,32: “S”; 90;180 
SET ALPHA MARGIN SEPARATION BR margin-separation PRINT @1,32: “BR”; 79.7 
SET ALPHA RATIO BI x-ratio,y-ratio PRINT @1,32: “BI”; 
1.5:1.63636 
SET ALPHA ROTATION R rotation-angle PRINT @1,32: “R”; 45 
SET ALPHA SCALE BH x-mag-factor,y-mag-factor PRINT @1,32: “BH”; 2;1 
SET ALPHA SIZE BZ character-width,character-height PRINT @1,32: “BZ”; 60;110 
SET ALPHA SLANT BG slant-angle PRINT @1,32: “BG”; 20 
SET TAB SEPARATION BT tab-separation PRINT@1,32: “BT”; 6.5 
Graphics Commands 
AXIS CA x-space,y-spacel,x-intercept,y-intercept] PRINT @1,32: “CA”; 5;10; 
50;50 
DRAW D x-value,y-valuel,x-value,y-valuel... PRINT @1,32: “D”; 2;40 
or PRINT@1,32: “D”; 2;40:7;9 
DRAW ARC AA x-mid,y-mid,x-end,y-end{,x-mid y-mid,x-end, PRINT @1,32: “AA”; 20;30; 
y-end]... 49;62 
DRAW CIRCLE AC radius[,radius]. PRINT @1,32: “AC”; 256 
| or PRINT@1,32: “AC”; 5;10; 
20 
MARK VIEWPORT CM PRINT @1,32: “CM” 
MOVE M x-value,y-value PRINT @1,32: “M”; 32;40 





20ne output message block produced. 
otwo output message blocks produced. 
©One output message block per macro. 
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Command : Format Example 
Graphics Commands (cont) 
MOVE TO LOAD POINT Al PRINT @1,32: “Al” 
OUTLINE VIEWPORT CB PRINT @1,32: “CB” 
READ VIEWPORT® CV PRINT @1,32: “CV” 
INPUT @1,32: V1,V2,T1 
INPUT @1,32: V3,V4,T2 
SELECT CLIPPING CONTROL AK selector PRINT @1,32: “AK”; 1 
0: viewport boundary 
1: page boundary 
SELECT COORDINATE TYPE BO coordinate-type-selector PRINT @1,32: “BO”; 1 
0: absolute 
1: relative 
SELECT DEVICE UNITS BV device-units-selector PRINT @1,32: “BV”; 1 
0: ADU i] 
1: GDU 
2: mm 
SELECT GRAPHIC UNITS BW input-selector[,output-selector] PRINT @1,32: “BW”; 1;1 8 
0: world or PRINT@1,32: “BW”; 1 5 
1: device ES 
single argument: use for input and output o 
a 
SELECT LINE TYPE BL line-type-selector PRINT@1,32: “BL”; 2 E 
0: solid 2: variable dash = 
1: fixed dash 3: end points only * 
SELECT PEN BP pen-selector PRINT @1,32: “BP”; 2 { 
1: Pen 1 0: quick time-out i 
2: Pen 2 3-255: no change in pen selection 
SET ARC SMOOTHNESS BA smoothness PRINT @1,32: “BA”; 0.5 
(0 to 1, 0 is very smooth, .5 default) 
SET DASH PATTERN BD pattern-elementl,pattern-elementl. PRINT @1,32: “BD”; 1:2 
Up to 20 pattern elements 
1st,3rd,etc. elements: “Draw” 
2nd,4th,etc. elements: “Move” 
0: “zero Move” if 1st element, 
“point” if 3rd,5th,etc., 
“zero Move” if 2nd,4th,etc.) 
SET DASH PATTERN LENGTH BS pattern-length PRINT @1,32: “BS”; 256 
SET VIEWPORT AV IIx,urx,lly,ury PRINT @1,32: “AV”: 0;1024; 
0;755.8 
SET WINDOW AW Iix,urx,lly,ury PRINT @1,32: “AW”; 0;360; 
—1;1 
Transformation Commands = 
RESTORE PREVIOUS TRANSFORM AY PRINT @1,32: “AY” 
SAVE CURRENT TRANSFORM AX PRINT @1,32: “AX” 
SET ORIGIN TO CURRENT POS AO PRINT @1,32: “AO” 
SET ROTATION AR angle PRINT @1,32: “AR”; 30 
SET ROTATION TO LAST ANGLE AL PRINT @1,32: “AL” 
SET SCALE AS x-scale,y-scale PRINT @1,32: “AS”; 2:4 
SET SKEW AQ x-skew-angle,y-skew-angle PRINT @1,32: “AQ”; 20:10 
SET TRANSLATION AT x-translation,y-translation PRINT @ 1,32: “AT”; 512; 
1024 











20ne output message block produced. 
btwo output message blocks produced. 
Sone output message block per macro. 


4663 PROGRAMMER’S REFERENCE 


(continued) 


D-3 


Appendix E 


c 


GPIB DESCRIPTION 


THE GENERAL PURPOSE INTERFACE BUS (GPIB) 


The GPIB is a standard interface for programmable describes a byte-serial, bit-parallel interface system for 
instrumentation defined in IEEE Standard 488-1978. programmable instruments. The GPIB connector is a 
The following descriptions summarize the parts of that standard 24-pin connector with sixteen active signal 
standard that apply to the Plotter. lines and eight interlaced grounds. The cable attached 


to the GPIB connector must be no longer than 65.6 ft 
(20 m) with no more than fifteen peripheral devices 
connected at one time. Refer to Figure E-1 for the 
connector pin arrangement and the respective signal 
line nomenclature. 


THE GPIB CONNECTOR 


The GPIB connector (located on the Plotter’s rear 
panel) permits Plotter access to GPIB devices. These 
devices must conform to IEEE Standard 488-1978 and 


Pe 


Romane 


ii ca Se a ea ea 





Figure E-1. Connector Pin Arrangement. 


€ 
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GPIB DESCRIPTION 


THE GPIB INTERFACING CONCEPT 


The GPIB is functionally divided into three component 
busses: an eight-line Data bus, a three-line Transfer 
bus, and a five-line Management bus for a total of 
sixteen active signal lines. Figure E-2 shows the bus 
structure. 


The transfer rate over the Data bus is a function of the 
slowest peripheral device taking part in a transfer at 
any one time. The bus operates asynchronously with a 
maximum transfer rate of 250K bytes/second (one 
megabyte/second with tri-state drivers). Both peripher- 
al addresses and data are sent sequentially over the 
Data Bus. Once peripheral addresses are established 





for a particular transfer, successive data bytes can be 
transmitted in a group for higher effective data rates. 


Peripheral devices on the GPIB are designated as 
talkers or listeners either manually by the Plotter’s 
front panel functions, or under program control by a 
controller device on the GPIB bus. 


A talker is a device capable of transmitting information 
on the Data bus. Only one talker can exist at a time. 


A listener is a device capable of receiving information 
transmitted over the Data bus. A maximum of fourteen 
listeners can receive directions in an I/O (input/output) 
operation at any one time. 


DIO1 
DIO2 
DIO3 
DIO4 
DIOS 
DIO6 
DIO7 


DIOs 
DATA BUS 


NRFD 
DAV 


NDAC 
TRANSFER BUS 


ATN 
SRQ 
IFC 
REN 
EOI 
MANAGEMENT BUS 


Figure E-2. Bus Structure. 
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GPIB DESCRIPTION 


GPIB SIGNAL DEFINITIONS 








The GPIB signal lines are described in three groups in Each byte represents a peripheral address (either 
the following discussions. primary or secondary), a control message, or a data 

byte. Data bytes sent to the Plotter are formatted in 
DATA BUS ASCIll code. 
The Data bus contains eight bidirectional active-low MANAGEMENT BUS 
signal lines, DIO1 through DIO8. One byte of informa- 
tion (eight bits) is transferred over the bus at a time. The Management bus is a group of five signal lines that 
DIO1 represents the least significant bit in the byte; control data transfers over the Data bus. The five 
DIO8 represents the most significant bit in the byte. signals and their definitions appear in Table E-1. 

Table E-1 
MANAGEMENT BUS SIGNALS 

Signal Line Definition 


Attention (ATN) 


Service Request 
(SRQ) 














This signal line is asserted by the controller while peripheral devices are assigned as listeners and talkers. 
Only peripheral addresses and control messages are transferred over the Data bus when ATN is active low. 
Once ATN goes high, only peripheral devices assigned as listeners and talkers can take part in the transfer 
of data bytes. The bus controller is the only source of this signal. 








Any peripherai device on the GPIB can request the attention of the controller by asserting SRQ as active low. 
The controller typically responds by asserting ATN active low and executing a serial poll to see which device 
is requesting service. If the controller is a 4050 Series Graphic Computer System, this response is enabled 
by an “ON SRQ THEN” statement, which is executed in the BASIC program. The serial poll is taken when a 
“POLL” statement is executed in the BASIC program. After the peripheral device requesting service is found, 
BASIC program control is transferred to a service routine for that device. When the service routine is finished 
executing, program control returns to the main program. The SRQ signal line is reset to an inactive state 
when the device requesting service is polled. 











Interface Clear 


(IFC) 


The IFC signal fine is asserted by the controller when all interface circuitry must be placed ina 
predetermined quiescent state. The bus controller is the only source of this signal. in a 4050 Series Graphic 
Computer System, IFC is activated each time the “INIT” statement is executed in a BASIC program or the 
4050 BREAK key is hit twice in succession. 








Remote Enable 
(REN) 


The REN signal line is asserted whenever the system is operating under program control. REN causes all 
peripheral devices on GPIB to ignore their front panel controls and operate under remote control by signals 
and/or control messages received over the GPIB. The 4663 Plotter has no REN capability. 








End or Identify 
(EOI) 





The EOI signal is used by the talker to indicate the end of a data transfer sequence. The talker activates EOI 
as the last byte of transmitted data. A listening bus controller (with EO! asserted) assumes a data byte being 
received is the last byte in the transmission. When the 4050 Series Graphic Computer System is talking, it 
always asserts EOI along with the last byte transferred. 





_ 
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GPIB DESCRIPTION 


THE TRANSFER BUS 


A handshake sequence is executed by the talker and 
the listeners over the Transfer bus each time a data 


byte is transferred over the Data bus. Signal lines and 
definitions for the Transfer bus appear in Table E-2. 


Table E-2 
TRANSFER BUS SIGNALS 























Signal Line Definition 
. 
Not Ready For An active low NRFD signal line indicates that one or more assigned listeners are not ready to receive the next 
Data (NRFD) data byte. When all assigned listeners for a particular data transfer have released NRFD, the NRFD line goes 
inactive high. This tells the talker to place the next data byte on the Data bus. 
Data Valid The DAV signal line is asserted by the talker shortly after a valid data byte is placed on the Data bus. An 
(DAV) active low DAV signal tells each listener to capture the data byte currently on the Data bus. The talker is 


inhibited from asserting DAV when NAFD is active low. 





No Data Accepted 
(NDAC) 





The NDAC signal line is held active low by each listener until that listener captures the data byte currently 
being transmitted over the Data bus. Once all listeners have captured the data byte, NDAC goes inactive high. 
This tells the talker to take the byte off the Data bus. 





GPIB DATA FORMATS 


Any series of 8-bit bytes can be transmitted over the 
GPIB. For the Plotter, both numeric data and alphanu- 
meric data are transmitted in ASCII code. 


TRANSFERRING ASCII DATA 


ASCII numeric data can be transferred in either integer, 
floating point format, or scientific notation format, as 
long as the most significant digit is transferred first. 
Valid ASCII numeric characters are digits 0 through 9, 
E,e,+,—, and the decimal point. ASCII character 
strings can be transmitted as any sequence of valid 
ASCII characters. All ASCII data transfers, both 
numeric and alphanumeric, are terminated with a 
Carriage return character and/or by activating the EOI 
signal line on the Management bus. 


When using a TEKTRONIX 4050 Series Graphic Sys- 
tem, ASCII data is transferred from the Graphic System 
to a Plotter or other peripheral device on the GPIB 
using the PRINT statement. ASCII transfers in the 
opposite direction are executed by using the INPUT 
statement. (Refer to the INPUT and PRINT statements 
in the Input/Output Operations section of the 4057 
Graphic System Reference Manual for detailed infor- 
mation on ASCII data transfers over the GPIB.) 


E-4 


TRANSFERRING ONE DATA BYTE ATA 
TIME 


When using a TEKTRONIX 4050 Series Graphic Sys- 
tem, direct access to the GPIB is available through the 
“WBYTE” (Write Byte) statement and the “RBYTE” 
(Read Byte) statement. These two statements permit 
sending any eight-bit bytes over the GPIB. Also, the 
“WBYTE” statement can assert the ATN signal line 
(telling peripheral devices that the byte you are 
sending is a peripheral address or a control message) 
and gives you complete control over the activation of 
the EOI signal line (except when a binary 0 is 
transferred). Refer to the WBYTE and RBYTE 
statements in the I/O Operations section of the 4057 
Graphic System Reference Manual. 
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GPIB DESCRIPTION 


GPIB TO IEEE COMPATIBILITY 


INTRODUCTION 


The following text describes the interfacing compatibil- 
ity of the Plotter’s GPIB interface with the IEEE 
Standard 488-1978. The Plotter can function as a 
standard talker or listener. 


4663 GPIB SUBSET 


The IEEE Standard 488-1978 requires each interface 
to contain a group of allowable GPIB function subsets. 
Table E-3 provides a list of subsets which the Plotter’s 
GPIB interface implements and gives a description of 
the GPIB interface capability. If needed, refer to the 
IEEE Standard 488-1978 for a detailed description of 
these subsets. 


Table E-3 
GPIB INTERFACE SUBSETS FOR THE PLOTTER 





ss 












































Implemented 
Function Subset Comments 
——————} 

SH (Source Handshake) SH1 Complete 
Capability 

AH (Acceptor Handshake) AH1 Complete 
Capability 

T (Talker) T5 Serial Poll, Talk 
Only, Unad- 
dress if MLA 

T (With Address Extension) | TEO No Capability 

L (Listener) L3 Listen Only, 
Unadaress if 
MTA 

L (With Address Extension) LEO | No Capability 

SR (Service Request) SR1 Complete 
Capability 

RL (Remote/Local) RLO No Capability 

PP (Parallel Poll) PPO No Capability 

DC (Device Clear) DC1 Complete 
Capability 

DT (Device Trigger) DTO No Capability 

C (Controller) co No Capability 
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NOTE 


Secondary addresses can be used to send com- 
mands to the Plotter. The use of secondary 
addresses as commands is not the same as the 
use of secondary addresses for extended ad- 
dressing functions. The Plotter accepts secon- 
dary addresses as commands to maintain 
compatiblity with the TEKTRONIX 4050 Series 
Graphic Computer Systems. 


EXCEPTIONS TO GPIB STANDARD 


The Plotter conforms to the electrical, mechanical, and 
procedural standards contained in IEEE Standard 488- 
1978 with the following exceptions: 


@ The Plotter might not (if it is busy processing 
commands) recognize an IFC (Interface Character) 
bus message if the message is asserted for the 
minimum time specified (100 nsec). The message 
should be asserted for at least 300 wsec to ensure a 
response under all conditions. 


@ The Plotter will not respond to an IFC bus message 
within the maximum time specified in the IEEE 
Standard (100 psec). The actual response time is 
165 wsec and the controller should delay about 200 
usec following an IFC bus message before using the 
GPIB. 


@ Excessive noise on the NRFD line of the GPIB can 
cause the Plotter (when addressed as a talker) to 
erroneously transmit data bytes when the listener is 
not ready to receive. 


@ |f the Plotter is addressed as a listener by being 
placed in the Listen Only mode, the listen function is 
not inhibited while the IFC bus message is asserted. 
This permits response to bus messages other than 
DCL (Device Clear) while IFC is asserted. 
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Appendix F 


COORDINATE CONVERSION CHART 


INTRODUCTION 


Tables F-1 through F-4 are designed for use with 12-, 
14-, 16-, and 10-bit graphing, respectively. Use the 


appropriate procedure described for your desired coor- 
dinate resolution. 


10-BIT GRAPHING 


10-bit graphing is the appropriate resolution for the 
TEKTRONIX 4010, 401 2, or 4013 Terminals. Simply 
use Table F-4 (Coordinate Conversion Chart). Find the 
desired X or Y coordinate in the body of the chart; 
follow that column to the bottom of the chart to find the 
decimal value or the ASCII character that represents 
the HIY or HIX byte; go to the far right in the row 
containing the coordinate value to find the LOY byte, or 


go to the left to find the LOX byte. With 10-bit graphing, 
it is not possible to use coordinate values between 
those shown on the chart. Arrange the characters in 
the sequence: 


HIY,LOY,HIX,LOX 
Example: 480X,100Y would be §p,y,#,X in ASCII code. 


12-BIT GRAPHING 


12-bit graphing is the appropriate resolution for the 
TEKTRONIX 4014 or 4015 Terminals. You must use 
Table F-1 (Interpolation Insert Chart) and Table F-4 
(Coordinate Conversion Chart). 


Simply find the largest coordinate value in Table F-4 
that is equal to or less than the desired coordinate 
value; follow that column to the bottom of the chart to 
find the decimal value or the ASCII character that 
represents the HIY or HIX byte; go to the right in the 
row containing that largest coordinate value equal to or 
less than the desired coordinate value to find the LOY 
byte, or go to the left to find the LOX byte. Then 
subtract this largest coordinate value in the chart that 
is equal to or less than the desired coordinate value. 
Repeat for the other coordinate value. Note both of 
these remainders and their respective axes (for the 
example below, X remainder = 1, Y remainder = 3). 
Notice that these values will always range from 0 to 3. 
Apply both of these remainders to Table F-1 (using the 
X remainder across the top and the Y remainder down 
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the left side) to determine the extra byte (EB) character 
in the sequence below. (Figure F-1 shows the in- 
creased resolution gained by the extra byte.) 


HIY,EB,LOY,HIX,LOX 


Example: 841X,31Y would be §p,m,g,&,R in ASCII 
code. 


Table F-1 


INTERPOLATION INSERT CHART 
(12-BIT RESOLUTION USING THE EB BYTE) 














Y Remainder X Remainder 
te] 1 2 3 
——- 
3 | m n (e} 
2 h i j k 
1 d e f g 
0 a b Cc 
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COORDINATE CONVERSION CHART 








































































































































































































RANGE: 0-4095 ADUS 
5 BIT RESOLUTION: 


T 
Mi ETT ax ann ary 4+4--4+-++-17 
= 4095Y,0X: F + + 4095Y,4095Y 
= a | ia | 
Nase a i H Prarie! 
A | Sian B oe we 
9 + | 
a) a Faas i ah 
8 | LE | Ht 
“ ; rH - | +—+—+ + 
5 B 
4 N 3 ca eS Fa {4 | ea 
3 2731Y,0 | [ 2731Y,4095X 
2 
: 7 HH 4 EH H Z 
0 
HI 
ae OM [ a | 
| |_| 
; ; (ie oeteat : | 128 ADUS 
sng) OM aD f |_| [al [ 
a 
) ; | 
( | | 
@ EEE EEE 
& | | 
% H il 
$ al | | 
al | Bw 
j | Lata |_| L H OY,4095X 
1 8p iE | e an ian 
Sp!" #$%& '(C)*~,-./0123456789: =>? 


RANGE: 0-3 ADUS 
12 BIT RESOLUTION: 
1 ADU 


RANGE: 0-0.75 ADU 
14 BIT RESOLUTION: 
0.25 ADU 

















Note that characters from the 
second LOY column may also be 
used; these are shown lor con- 
sistency. 


€EB 














HI Xx 


ah 


sence Emenee 











LOW X AND LOW Y :— 





LOX 


10 BIT RESOLUTION: 
‘14 ADUS 





RANGE: 0-0.1875 ADU 





These two extra bytes are 
used for 16-bit graph- 
ics—not necessary for Tek- 
tronix 4014 terminals. 


16 BIT RESOLUTION: 
0.0625 ADU 








Note that characters from the 
second LOY column may also be 
used; these are shown for con- 
sistency. 





Note that characters trom the 
second LOY column may also be 
used: these are shown for con- 
sistency. 


(2670)3806-64 


Figure F-1. X-Y Coordinates (Showing the Increased Resolution Gained by the Extra Byte). 
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EE la 


COORDINATE CONVERSION CHART 


14-BIT AND 16-BIT GRAPHING 














For graphics coordinates with additional resolution Table F-3 
(14-bit or 16-bit), repeat the 12-bit graphing process INTERPOLATION INSERT CHART 
previously described to determine the EEB or EEEB (16-BIT RESOLUTION USING THE EEEB BYTE) 
bytes by obtaining a remainder using Tables F-2 or F-3. 
For 16-bit resolution, arrange the characters in the Y Remainder X Remainder 
following sequence: re) 0.0625/0.125 | 0.1875 
a ———— 
HIY,EEEB,EEB,EB,LOY,HIX,LOX 0.1875 | m n ° 
0.125 h i j k 
Examples: OX,0Y would be §p'*''Sp@ in ASCII code. d 
0.0625 d e f g 
480.375X,100.875Y would be Spjm' y#x 0 ‘ a b c 














in ASCII code. 








Refer to the introduction to commands and responses 
Table F-2 in Section 4 or 5 for further information. 


INTERPOLATION INSERT CHART 
(14-BIT RESOLUTION USING THE EEB BYTE) 


— 














Y Remainder X Remainder 
(0) 0.25 0.50 0.75 
ne 
0.75 | m n fe) 
0.50 h i j k 
0.25 d e f g 
6) : a b Cc 
: 
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COORDINATE CONVERSION CHART 


Table F-4 
COORDINATE CONVERSION CHART 

















Low Order X Low Order Y 
ASCII DEC. X or Y Coordinate DEC. ASCII 
@ 64 i ce) 128 256 384 51:2 640 768 896 96 , 
A 65 4 132 260 388 516 644 772 900 97 a 
B 66 8 136 264 392 520 648 776 904 98 b 
Cc 67 12 140 268 396 524 652 780 908 99 ¢c 
D 68 16 144 272 400 528 656 784 912 100 d 
E 69 20 148 276 404 532 660 788 916 101 e 
F 70 24 152 280 408 536 664 792 920 | 102 f 
G 71 28 156 284 412 540 668 796 924 103 g 
H 72 32 160 288 416 544 672 800 928 | 104 h 
l 73 36 164 292 420 548 676 804 932 105 i 
J 74 40 168 296 424 552 680 808 936 106 j 
K 75 44 172 300 428 556 684 812 940 | 107 k 
E 76 48 176 304 432 560 672 816 944 108 | 
M Ae 52 180 308 436 564 676 820 948 | 109 m 
N 78 56 184 312 440 568 680 824 952 110 n 
(e) 79 60 188 316 444 572 684 828 956 111 co) 
P 80 64 192 320 448 576 688 832 960 112 p 
Q 81 68 196 324 452 580 672 836 964 | 113 q 
R 82 72 200 328 456 584 676 840 968 | 114 r 
Ss 83 76 204 332 460 588 680 844 972 AS) s 
Th 84 80 208 336 464 592 784 848 976 116 t 
U 85 84 212 340 468 596 788 852 980 WF u 
Vv 86 88 216 344 472 600 792 856 984 118 v 
WwW 87 92 220 348 476 604 796 860 988 119 Ww 
Xx 88 96 224 352 480 608 800 864 992 120 x 
24 89 100 228 356 484 612 804 868 996 121 y 
Zz 90 104 232 360 488 616 808 872 1002 122 z 
[ 91 108 236 364 492 620 812 876 1006 123 { 
\ 92 112 240 368 496 624 816 880 1010 124 
] 93 116 244 372 500 628 820 884 1012 125 } 
A 94 120 248 376 504 632 824 888 1016 126 a 
= 95 124 252 380 508 636 828 892 1020 127 ieee 
T 
DEC. ——— > 32 33 34 35 36 37 3839 | 
ASCII------ > Sp | - # $ % & 
High Order X & Y 
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Table F-4 (cont) 


COORDINATE CONVERSION CHART 



































Low Order X Low Order Y 
ASCIl DEC. X or Y Coordinate DEC. ASCII 
@ 64 1024 1152 1280 1408 1536 1664 1792 1920 96 : 
A 65 1028 1156 1284 1412 1540 1668 1796 1924 97 a 
B 66 1032 1160 1288 1416 1544 1672 1800 1928 98 b 
C 67 1036 1164 1292 1420 1548 1676 1804 1932 99 c 
D 68 1040 1168 1296 1424 1552 1680 1808 1936 100 d 
E 69 1044 1172 1300 1428 1556 1684 1812 1940 101 e 
F 70 1048 1176 1304 1432 1560 1688 1816 1944 102 f 
G 71 1052 1180 1308 1436 1564 1692 1820 1948 103 g 
H 72 1056 1184 1312 1440 1568 1696 1824 1952 104 h 
| 73 1060 1188 1316 1444 1572 1700 1828 1956 105 
J 74 1064 1192 1320 1448 1576 1704 1832 1960 106 j 
K 15 1068 1196 1324 1452 1580 1708 1836 1964 107 k 
L 76 1072 1200 1328 1456 1584 1712 1840 1968 108 | 
M 77 1076 1204 1332 1460 1588 1716 1844 1972 109 m 
N 78 1080 1208 1336 1464 1592 1720 1848 1976 110 n 
Oo 79 1084 1212 1340 1468 1596 1724 1852 1980 111 fe) 
P 80 1088 1216 1344 1472 1600 1728 1856 1984 112 p 
Q 81 1092 1220 1348 1476 1604 1732 1860 1988 113 q 
R 82 1096 1224 1352 1480 1608 1736 1864 1992 114 r 
SS) 83 1100 1228 1356 1484 1612 1740 1868 1996 115 s 
T 84 1104 1232 1360 1488 1616 1744 1872 1200 116 t 
U 85 1108 1236 1364 1492 1620 1748 1876 2004 117 u 
V 86 112 1240 1368 1496 1624 1752 1880 2008 118 v 
W 87 1116 1244 1372 1500 1628 1756 1884 2012 119 Ww 
Xx 88 1120 1248 1376 1504 1632 1760 1888 2016 120 x 
y 89 1124 1252 1380 1508 1636 1764 1892 2020 121 y 
z 90 1128 1256 1384 1512 1640 1768 1896 2024 122 Zz 
[ 91 1132 1260 1388 1516 1644 1772 1900 2028 123 { 
\ 92 1136 1264 1392 1520 1648 1776 1904 2032 124 | 
] 93 1140 1268 1396 1524 1652 1780 1908 2036 125 } 
A 94 1144 1272 1400 1528 1656 1784 1912 2040 126 = 
= 95 1148 1276 1404 1532 1660 1788 1916 2044 127 eee ut 
T 
DEC. ------ > 40 41 42 43 44 45 46 47 
ASCII------ > ( ) : + - / 





High Order X & Y 
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COORDINATE CONVERSION CHART 


Table F-4 (cont) 
COORDINATE CONVERSION CHART 

















Low Order X i Low Order Y 
ASCII DEC. a X or Y Coordinate DEC. ASCII 
@ 64 2048 2176 2304 2432 2560 2688 2816 2944 1 96 J 
A 65 2052 2180 2308 2436 2564 2692 2820 2948 97 a 
B 66 2056 2184 2312 2440 2568 2696 2824 2952 98 b 
Cc 67 2060 2188 2316 2444 2572 2700 2828 2956 99 c 
D 68 2064 2192 2320 2448 2576 2704 2832 2960 100 d 
E 69 2068 2196 2324 2452 2580 2708 2836 2964 101 e 
F 70 2072 2200 2328 2456 2584 2712 2840 2968 102 f 
G 71 2076 2204 2332 2460 2588 2716 2844 2972 103 g 
H 72 2080 2208 2336 2464 2592 2720 2848 2976 104 h 
| 73 2084 2212 2340 2468 2596 2724 2852 2980 105 i 
J 74 | 2088 2216 2344 2472 2600 2728 2856 2984 106 j 
K 75 | 2092 2220 2348 2476 2604 2732 2860 2988 107 k 
L 76 2096 2224 2352 2480 2608 2736 2864 2992 108 
M 77 2100 2228 2356 2484 2612 2740 2868 2996 109 m 
N 78 2104 2232 2360 2488 2616 2744 2872 3000 110 n 
Oo 79 2108 2236 2364 2492 2620 2748 2876 3004 10 fe) 
P 80 2112 2240 2368 2496 2624 2752 2880 3008 4172 p 
Q 81 2116 2244 2372 2500 2628 2756 2884 3012 113 q 
R 82 2120 2248 2376 2504 2632 2760 2888 3016 114 r 
Ss 83 2124 2252 2380 2508 2636 2764 2892 3020 115 s 
T 84 2128 2256 2384 2512 2640 2768 2896 3024 116 t 
U 85 2132 2260 2388 2516 2644 2772 2900 3028 117 U 
Vv 86 2136 2264 2392 2520 2648 2776 2904 3032 118 Vv 
WwW 87 2140 2268 2396 2524 2652 2780 2908 3036 119 Ww 
X 88 2144 2272 2400 2528 2656 2784 2912 3040 120 x 
Y 89 2148 2276 2404 2532 2650 2788 2916 3044 121 y 
Zz 90 2152 2280 2408 2536 2664 2792 2920 3048 122 z 
[ 91 2156 2284 2412 2540 2668 2796 2924 3052 423 ( 
\ 92 2160 2288 2416 2544 2672 2800 2928 3056 124 
] 93 2164 2292 2420 2548 2676 2804 2932 3060 125 } 
A 94 2168 2296 2424 2552 2680 2812 2936 3064 126 
= 95 2172 2300 2423 2556 2684 2816 2940 3068 127 ites 
i fi 
ia.» | 4 <9 68 sf 62 #6 S4 S&]| 
ASCIl------ > 0 1 zZ 3 4 5 6 7 
High Order X & Y | 
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ww Table F-4 (cont) 
COORDINATE CONVERSION CHART 

Low Order X = Low Order Y 
ASCII DEC. X or Y Coordinate Ie ASCII 
@ 64 3072 3200 3328 3456 3584 3712 3840 3968 96 i 
A 65 3076 3204 3332 3460 3588 3716 3844 3972 97 a 
B 66 3080 3208 3336 3464 3592 3720 3848 3976 98 b 
Cc 67 3084 3212 3340 3468 3596 3724 3852 3980 99 c 
D 68 3088 3216 3344 3472 3600 3728 3856 3984 100 d 
E 69 3092 3220 3348 3476 3604 3732 3860 3988 101 e 
F 70 3096 3224 3352 3480 3608 3736 3864 3992 102 f 
G fA 3100 3228 3356 3484 3612 3740 3868 3996 103 g 
H 72 3104 3232 3360 3488 3616 3744 3872 4000 104 h 
| 73 3108 3236 3364 3492 3620 3748 3876 4004 105 i 
J 74 3112 3240 3368 3496 3624 3752 3880 4008 106 j 
K 75 3116 3244 3372 3500 3628 3756 3884 4012 107 kK 
L 76 3120 3248 3376 3504 3632 3760 3888 4016 | 108 | 
M Tf 3124 3252 3380 3508 3636 3764 3892 4020 109 m 
N 78 3128 3256 3384 3512 3640 3768 3896 4024 110 n 
O 79 3132 3260 3388 3516 3644 3772 3900 4028 111 ° 

w P 80 3136 3264 3392 3520 3648 3776 3904 4032 112 p 
Q 81 3140 3268 3396 3524 3652 3780 3908 4036 113 q 
R 82 3144 3272 3400 3528 3656 3784 3912 4040 |114 r 
Ss 83 3148 3276 3404 3532 3660 3788 3916 4044 115 s 
T 84 3152 3280 3408 3536 3664 3792 3920 4052 116 t 
U 85 3156 3284 3412 3540 3668 3796 3924 4056 VAN u 
Vv 86 3160 3288 3416 3544 3672 3800 3928 4060 118 Vv 
Ww 87 3164 3292 3420 3548 3676 3804 3932 4064 119 Ww 
x 88 3168 3296 3424 3552 3680 3808 3936 4068 | 120 x 
Y 89 3172 3300 3428 3556 3684 3812 3940 4072 | 121 y 
Zz 90 3176 3304 3432 3560 3688 3816 3944 4076 | 122 z 
[ 91 3180 3308 3436 3564 3692 3820 3948 4080 |123 { 
\ 92 3184 3312 3440 3568 3696 3824 3952 4084 |124 
] 93 3188 3316 3444 3572 3700 3828 3956 4088 | 125 } 
A 94 3192 3320 3448 3576 3704 3832 3960 4092 126 ce 
= 95 3196 3324 3452 3580 3708 3836 3964 4096 127 rubout 

Or 
DEC.-----> | 56 57 58 #59 #60 61 «62+ 63 | 
ASCII------ > 8 9 : ; < = > ? 
High Order X & Y 
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Appendix H 


USING A 4663 IN A 4662 SYSTEM SETUP 


INTRODUCTION 


This appendix describes limitations of the TEKTRONIX 
4663 Plotter when substituted into a system that is 
programmed for a TEKTRONIX 4662 Plotter. These 


limitations may require small program adjustments to 
permit the 4663 Plotter to correctly interpret com- 
mands intended for a 4662 Plotter. 


SERIAL INTERFACE OPERATION 


The following information pertains only to Serial inter- 
face use. 


CHARACTER ARGUMENTS 


A 4662 character argument corresponds to a 4663 
undelimited string argument that is one character long. 
However, 4663 undelimited string arguments cannot 
contain the following characters: 


Sp, Comma, Slash, Quote, Apostrophe, or 4t 


These characters must be expressed within a delimited 
string (versus an undelimited string) to be used in 
4663 string arguments. 
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NUMERIC ARGUMENTS 

The 4662 numeric arguments for the following com- 
mands must be integer values only: 

@ BLOCK END 

e SET TURNAROUND DELAY 

@ SET BLOCKSIZE 

To be compatible with the 4663, the arguments for 


these commands must not be terminated by any of the 
following characters: 


. (period) 
E 
e 


These characters would be interpreted as part of the 
more general numeric argument forms allowed for all 
4663 numeric arguments. 
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A 4663 IN A 4662 SYSTEM 


MAXIMUM BLOCK MODE BLOCKSIZE 
SPECIFICATION 


In the standard 4662 Plotter, the maximum Block mode 
blocksize is about 1500 characters (or about 7500 
characters with an additional input buffer memory 
installed — Option 30). For 4663 operating baud rates 
of 2400 or less, the maximum blocksize varies from 
340 to 1020 characters, depending upon the internal 
expansion factor. If the baud rate is greater than 2400, 
additional blocksize restrictions may apply. Refer to 
Block Mode Communication in Section 4 fora 
discussion of the maximum blocksize specification. In 
most applications, a typical blocksize for both Plotters 
is approximately 150 characters. 


DEVICE RESET COMMAND 


A 4663 Plotter DEVICE RESET command does not 
reset interface communications parameters (this is 
done by an INTERFACE PARAMETER RESET com- 


mand); neither command clears the 4663 output buffer. 


The 4663 output buffer can be cleared with a front 
panel Initialize function. 
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OPERATOR DIGITIZE OPERATION 


When digitizing with the 4662, the PEN and CALL 
buttons specify Move or Draw points. With the 4663, 
the front panel Move Point or Draw Point functions 
specify the points where the digitizing is done with the 
crosshair; the pen is physically always up. In addition, 
the Last Point function is used on the 4663 to 
terminate a sequence of points. To terminate a se- 
quence of points on the 4662 Plotter, hold the CALL 
button down until you hear a beep. 


READ STATUS COMMAND 


The information reported in Bits 10 through 15 of 
Status Word 0 and Bits 11 through 15 of Status Word 1 
are different. Refer to the respective READ STATUS 
command descriptions of each plotter for details. In 
addition, the 4663 has defined responses for Status 
Words 2 through 7 while the 4662 returns zeros. 


SET STATUS COMMAND 
The 4663 Plotter does not support the SET STATUS 


command. The “P’’ command code is used for a PRINT 
command instead. 
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GPIB INTERFACE OPERATION 


The following information pertains only to GPIB inter- 
face use. 


SRQ FUNCTION 


Programs using the CALL DIGITIZE function (which 
reads a single point at each occurrence of the SRQ bus 
message) will fail to read all the coordinates when used 
with the 4663 Plotter if coordinates are generated 
faster than they are read. Avoid this situation by adding 
a Serial Poll operation so that after the SRQ message 
occurs, coordinates are read until Bit 7 (in the Serial 
Poll Status byte) reads 0. 


CALL DIGITIZE FUNCTION 


The 4663 Plotter can only transmit output responses in 
the order requested. Thus, other output cannot be read 
from the 4663 when there is a CALL DIGITIZE 
response pending (as can be done with the 4662 
Plotter). 


OPERATOR DIGITIZE OPERATION 


When digitizing with the 4662, the PEN and CALL 
buttons specify Move or Draw points. With the 4663, 
the front panel Move Point or Draw Point functions 
specify the points where the digitizing is done with the 
crosshair; the pen is physically always up. In addition, 
the Last Point function is used on the 4663 to 
terminate a sequence of points. To terminate a 
sequence of points on the 4662 Plotter, hold the CALL 
button down until you hear a beep. The 4663 termina- 
tion action causes a three-value response to be 
transmitted (Status Word O, Status Word 1, and TAG), 
while the 4662 termination action causes a single 
value status response to be transmitted (Status 

Word 0). 


READ STATUS COMMAND 


The information reported in Bits 10 through 15 of 
Status Word 0 and Bits 11 through 15 of Status Word 1 
are different. Refer to the respective READ STATUS 
command descriptions of each plotter for details. For 
example, the 4663 has defined responses for Status 
Words 2 through 7 while the 4662 returns zeros. 
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SET STATUS COMMAND 


The 4663 Plotter does not support the SET STATUS 
command. The “W” command code is not used. 


DEVICE RESET COMMAND 


A 4663 DEVICE RESET command does not clear the 
output buffer. The output buffer can be cleared with a 
front panel Initialize function. 


OUTPUT NUMERIC RANGE 


Noncoordinate numeric output in ASCII decimal form 
(such as status responses) from the 4662 has a range 
of —32767 to + 32767 while the output range from the 
4663 is 0 to 65535. 


DEVICE ADDRESSES 


The 4662 device addresses can be set from 0 to 31. 
The 4663 device addresses can be set from 1 to 7. 


MSA COMMAND DISABLE 


The MSA command form cannot be disabled on the 
4663 Plotter. 


IFC (INTERFACE CLEAR FUNCTION) 


The 4662 performs a Device Reset function (in addition 
to the Interface Clear function) when an IFC bus 
message is received. The 4663 Plotter performs only 
the Interface Clear function. You must use the DEVICE 
RESET command to perform a Device Reset function in 
the 4663. 
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PLOTTER/4014 COMMAND COMPATIBILITY 


The following tables indicate the Plotter action each 
ASCII character causes with respect to the current 
command decoding mode. These actions are as close 
as possible to the action the character would initiate if 
it were received by a 4014 terminal equipped with the 
Extended Graphics Module (EGM) Option that was in 
the same mode. 


The response of most 4010 Series terminals is similar 
to the response of a 4014 (except for EGM-indicated 
functions). If the action described in the tables does 
not duplicate the terminal action, it is because: 


@ The command is not within the capabilities of the 
Plotter. 


@ There is a corresponding command for the Plotter 
(implemented uniquely, either because it is desired 
to perform the function independently of the termi- 
nal, or because there is more data required to 
perform the function for the Plotter, requiring an 
expanded calling sequence). 


@ The Plotter is a loop-thru device intended for use in 
conjunction with a terminal. This dictates that some 
functions be slightly different to complement the 
capabilities of the terminal. 


4663 PROGRAMMER'S REFERENCE 


In summary, all major EGM functions for 4014’s and 
4016's are supported with the exception of: 


(Not supported) 
(Not supported) 
(Not supported) 
(Not supported) 
(Drawn as normal vectors) 
(Drawn as normal vectors) 


@ Margin 1 

e@ Alpha Wraparound 
® Special Point Plot 

@ Incremental Plot 

@ Write-Thru Vectors 
@ Defocused Vectors 


The Style Il command characters and Plotter re- 
sponses are summarized in Table I-1. The action 
shown in this table assumes that the alpha tab 
separator parameter is O and that the current attention 
character is -c. The characters shown in the table 
begin with Nu (ADE 1) and increase up to °r (ADE 127), 
as listed in Appendix B. 


NOTE 


Attention Action mode is referred to in the 4014 
documentation as LCE (Last Character Escape) 
mode. 


PLOTTER/4014 COMMAND CAPABILITY 











































































































Table I-1 
4663 STYLE II COMMAND CHARACTERS 
= 
Character Effect 
Character a1, | 
Alpha Mode Graph/Point Plot Mode Attention Action Mode 
Ss 
Ny | Remain in 4t mode 
Sy Return from 4t mode with no action 
through 
AK 
By Ring bell Ring bell, set next graphic coordinate | Ring bell, does not set next graphic 
interpretation to DRAW coordinate interpretation to DRAW 
Bs Move left 1 space, no wraparound at Return from 4t mode, does not move 
left margin left one space 
{— ia 
Hy Move right 1 space, wraparound at Return from “t mode, does not move 
right margin with auto ©r/‘ if margin right one space 
is active 
be Move down 1 line, no wraparound or Remain in 4t mode, does not do tr 
move to Margin 1 
Vy Move up 1 line, no wraparound at top Return from 4t mode, does not move 
of page one line up 
Fe Move to home position and set Alpha 
mode, set solid line type, does not 
clear extra graphic bytes 
=i Paks 
CR Move to left margin, does not clear | Does not set Alpha mode, does not ~T Remain in 4t mode, does not do r 
extra graphic bytes, no ©r/‘F option do Sr 
(2741 Interface) 
So Begin circle spec, the X part of the Activates alternate alpha font 
coordinate pair is interpreted as radi- 
us (Option 31 only) 
—— tl 
s; Begin arc spec, next two coordinate Activates standard alpha font 
pairs are interpreted as the 
intermediate and end points of the 
arc (Option 31 only) 
DL | Return from 4t mode with no action 
through 
Sp | 
Ec Set At mode® Set At mode Remain in 4t mode® 
Fs Set Point mode, save Line type Set Point mode, save Line type Return from “tT mode, does not do 
special point plot 
aarele | 
Gg Set Graph mode, set next graphic Set next graphic coordinate interpre- {| Set Graph mode if now in Alpha 
coordinate interpretation to MOVE tation to MOVE mode, set next graphic coordinate 
interpretation to MOVE 
+ 7 
Rg Does not do incremental plot Does not do incremental plot Return from 4t mode, does not do 
incremental plot 
Us Set Alpha mode, restore line type Set Alpha mode, restore line type 
Bs 
1-2 4663 PROGRAMMER’S REFERENCE 


~ 


| 


4663 STYLE Il COMMAND CHARACTERS 


PLOTTER/4014 COMMAND CAPABILITY 


Table !-1 (cont.) 
















































































Character Effect 
Character 
Alpha Mode Graph/Point Plot Mode Attention Action Mode 
=_ ——— 
Sp and DRAW character HIY or HIX. If last graphic byte re- Return from 4t mode with no action 
1 thru 7 ceived was not LOY or if a Ss was 
received after the last LOY, then 
interpret as a HIY graphic byte. If last 
graphic byte was LOY, then set HIX 
a 
8 Set character dimension to 4014 
large character size 
9 Set character dimension to 4014 #2 
character size 
Set character dimension to 4014 #3 
character size 
; Set character dimension to 4014 
small character size 
a= > Return from 4t mode with no action 
SS 
2 The ? character is converted toa °L 
and interpreted as a LOY graphic 
byte 
@thru ~ Interpret as LOX graphic byte, exe- Return from 4t mode with no action 
cute MOVE, DRAW, ARC, or CIRCLE. 
— Set next graphic coordinate 
interpretation to DRAW 
‘and DRAW character Interpret as LOY graphic byte. If last Set SOLID line type, does not do 
ethruh byte was LOY, set previous LOY as “defocus” or “write-through” 
m thru p extra graphic byte (EB), previous EB 
u thru w as EEB, and previous EEB as EEEB 
aiq Set 4014 DOTTED line type, does not 
do “defocus” or “write-through” 
ee 
bjr Set 4014 DOT-DASH line type, does 
not do “defocus” or “write-through” 
cks Set 4014 SHORT DASH line type, 
does not do “defocus” or ‘“‘write- 
through” 
dit Set 4014 LONG DASH line type, 
does not do “defocus” or ‘‘write- 
through” 
Dy Draw °r unless DEL IGNORE is i interpret as LOY graphic byte unless | Remain in “t mode 
specified DEL IGNORE specified 

















®These actions are the effects of whatever character has been selected as the current attention character. 
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Appendix J 


ERROR TYPES 


The following tables show the Parameter Entry switch 
display for each error type used in the Plotter. Table 
J-1 lists nonfatal error types while Table J-2 lists fatal 
error types. The Parameter Entry display shows the 
states of the lighted switches on the Parameter Entry 
Module if (1) the Parameter Entry Card was pushed all 
the way in when the error occurred, or (2) the Error 


Data line on the Parameter Entry Card has been 
selected and the ERROR CODE SWITCH is pressed. All 
references to errors in this manual identify the errors 
by the HEX equivalent value of the light displays. Refer 
to the Error Data Line description in the 4663 Opera- 
tor’s Manual! to access the error parameters using the 
Parameter Entry Module. 


NONFATAL ERRORS 


Nonfatal errors shown in Table J-1 indicate when the 
Plotter is unable to recognize or perform a command. 
The usual response is that the command is ignored or 
some assumptions are made and processing contin- 
ues. The first group of errors (01 through OC) indicate a 
problem in communicating with the Plotter. The second 
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group of errors (40 through 51) indicate a problem with 
recognition and/or specification of a command. The 
third group (80 through 8D) indicate problems with 
command processing (which may be caused by the 
specification and/or use of a command). 


J-1 


ERROR TYPES 


* = Light is ON 





Parameter 
Entry Display 


Table J-1 
NONFATAL ERROR TYPES 








Hex | Decimal | Cause of Error 





Parameter 
Entry Display Hex 






Decimal | Cause of Error 











OOO00000 * 01 


Serial—data overrun 





Serial—framing error 








|[Serial—parity error 





O00000 *O 02 |:2 
—————————— 
000000 * 03 |3 
00000 *00 04 |4 


Serial—input buffer full 
error 





OOO00O0*0* 05 |5 


Output attempt when mes- 
sage is in progress 





OQO0000 * *O 06 |6 
OOOCOO*X** | 07 |7 


Unused 
Output Buffer full 








OQ0000* 000 08 |8 


Serial—block size exceeds 
input buffer size 





0000 *00* 09 |9 


ISeridlblodk checksum 
error 





0000 *0 *O OA |10 


GP|B— illegal secondary 
ddress 





0000 *0** OB | 11 


Unused 





O000* *0O0 oc |12 


Unused 





O* 000000 40 |64 


Integer argument exceeds 
16-bit value 





O*OQOO000* 41 |65 


\llegal paper advance com- 
mand 





O*xOQ000*O 42 |66 


Illegal macro command 
usage 





O*OO000** 43 |67 


Macro called itself 





O*xO00*00 44 |68 


Integer outside legal range 





aI 


O*xO00*O* 45 |69 


Toc many entries or string 


too long (dash pattern) 








Ox000**O | 46 |70 





O*OOO#*KK | 47 | 71 





Unused 


Unidentified interface 
command error 








O*00*000 48 |72 








O*00 *00* 49 173 
O*OO*OKO | 4A | 74 








OxOOxO*xx | 4B | 75 
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Invalid command for select- 








outside page boundary 


Window less than or equal 
toO 















Ox00*# *O0O fl 76 








Ox00* *O* 


O*x00***O | 4E | 78 
O*00*k*** | 4F | 79 
O*0*0000 | 50 | 80 





O*O*x000* | 51 | 81 


*OO00000 80 | 128 


aS aes (ho 





Page upper-right on top of 
lower-left position 





Argument type error (inter- 
face) 








Unused 





Output value range error 





Illegal downloadable char- 
acter command 








Illegal downloadable 
character command usage 





Invalid switch entry (Param- 
eter Entry) 





*OOO000O* | 81 | 129 
———— et ee | 


Battery backup RAM 
checksum error 





*0O000 *O 82 | 130 


Transform stack underflow 
or overflow 





*OO000* * 83 | 131 


Transform cannot produce 
virtual digitizing data be- 
cause of transform values 





*O0000*00 84 | 132 


RAM verify error—block not 
used 





*OOOO*O* | 85 | 133 


Insufficient memory for 
buffer allocation 





*OO00* *O 86 | 134 








Cannot find specified ma- 
cro 





*OOOOK * & 87 | 135 


\ltegal alpha table command 
type 





*O000*000 88 | 136 


Unused 





*O00 *00* 89 | 137 


Illegal monitor usage 





*000 *O*O BA | 138 





+ 
*OOOKOKX | 8B | 139 


Output processing routine 
missing 
Number greater than 


99999.999 in fixed ASCII 
conversion 





*OO0O0* *OO 8C | 140 





Too many PROM alpha 
tables in system 





*OOO*X*O# (8D | 141 








Selected interface hard- 
ware or ROM not present 
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ERROR TYPES 


FATAL ERRORS 


Fatal errors normally indicate either a Plotter failure or 
incorrect installation of Plotter hardware. Fatal errors 
OA and 11 indicate unexpected software processing 
conditions that can occur from improper use of Plotter 
commands. The remainder of the fatal errors usually 
indicate a hardware failure and require diagnosis by a 
qualified service technician. 


NOTE 


Under some conditions, a fatal error will lock up 
the Plotter's Parameter Entry Module and prevent 
access of any error parameters. 
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Table J-2 
FATAL ERROR TYPES 


* = Light is ON 


Parameter 
Entry Display Hex 


OOO00000* 












Decimal | Cause of Error 
Insufficient RAM 




























O00000*0 | 02 #2 | RAM check error 
oo00c0** | 03 |3 ROM check error 
OO0000*00 04 /4 Undefined common subrou- 


tine 











Command dispatch error 






Software interrupt 





OOO0O*x0* 05 
OO000* *O 06 


OOOO0O0 ** x 07 









Nonmaskable interrupt 






Nonexistent memory 
reference 
















Unable to create a buffer 
(insufficient RAM) 


Unexpected system error 








No service routine for level 





No self interrupt routine for 
level 





Motion Synchronization 
address not in first 256 
bytes of ROM 


No routine for specified 
system command 


OOO0O*#* *O* 








OOO0O* * *O 








OOOO ** ** 
O00* OOOO 
OOO*O000* $11 =| 17 


ROM in wrong socket 





Motion buffer overrun 














Unexpected memory over- 
flow 
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ERROR TYPES 


NONFATAL ERROR CAUSES AND RESPONSES 


The following listing describes possible causes for 
each nonfatal error detected by the Plotter. The 
Plotter’s response to the error condition is also indicat- 
ed (when appropriate). You can use either the hexide- 
cimal or decimal forms of the error number to locate the 
error description. Decimal values can be used if the 
error parameter was obtained by a READ ERROR 
command response. Hexidecimal values are decoded 
from the lights on the Parameter Entry Module. 


Some errors listed can be generated by more than one 
cause. For most errors, refering to the indicated error 
parameters (EP1, EP2,...) may identify the cause of 
the error. Both the hex and decimal equivalents of the 
error parameter entries are listed. For the few errors 





y 
HEX | DEC | Description (Nonfatal Errors) 








where error parameter information is insufficient to 
identify the error cause, the Plotter functions performed 
at the time of error reporting may help identify the error 
cause. Refer to the 4663 Interactive Digital! Plotter 
Operator’s Manual for more information on how to read 
the error parameters. 


The description of most errors refers to related Plotter 
commands. Go to the appropriate command description 
for more information about legal and illegal usage of 
the command. 


When the contents of an error parameter is the ASCII 
Decimal Equivalent value of the character, refer to 
Appendix B to determine the character. 

















01 1. 


———_}__—__+ 


Serial — Data Overrun 





Plotter processing does not allow characters to be read as fast as they are received and characters 
have been lost. Switch to a lower baud rate. 




















02 2. Serial — Framing Error 
rf 
A garbled character was received and characters have been lost. Usually due to a noisy 
communication environment or wrong baud rate. 
=| 
03 3. Serial — Parity Error 





Character is used as received. 


Occurs when character is garbled or when receive parity selection does not agree with the host. 














04 4. Seria! — Input Buffer Full Error 
| Ability of the Plotter to temporarily store commands has been exceeded and some commands are lost. 
Input rate control method is inappropriate (see Serial Interface section). 
05 5. Output Attempt When Message Is In Progress 





ENABLE commana). 


Another type of output was requested while operator digitizing was enabled (non-permanently). 
Operator digitizing is disabled and the requested response is transmitted, (Gee OPERATOR DIGITIZE 





06 6. Unused 
ee aS 





























07 fe Output Buffer Full 
More than 127 output requests have been received and no responses have been transmitted. 
ij Command is ignored. 
08 | 8. | Serial — Block Size Exceeds Input Buffer Size 
SET BLOCK SIZE command argument larger than bytes available for input buffer use. Block size is set 
3 to 0. (See Serial Interface section). 
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ERROR TYPES 













































































HEX | DEC | DESCRIPTION (Nonfatal Errors) 
—— 
09 9. Serial — Block Checksum Error 
A garbled blockmode block has been received. Block is discarded and a negative acknowledge is 
generated. 
EP2= Received checksum (high byte) 
EP3= Received checksum (low byte) 
EP4= Computed checksum (high byte) 
EP5= Computed checksum (low byte) 
OA | 10. | GPIB — Illegal Secondary Address 
While the Plotter has been addressed as a listener or is in Listen Only mode, a secondary address is 
received that does not have a TEKTRONIX 4050 Series secondary address command definition. The 
secondary address is ignored. 
OB 11. | Unused 
oc 12. | Unused 
40 64. | integer Argument Exceeds 16-Bit Value 
The argument of an OPERATOR DIGITIZE ENABLE command is less than 0 or greater than 65535. The 
command is ignored. 
41 65. | Illegal Paper Advance Command 
An illegal media change command/function has been received or activated via the front panel while 
the media mode is sheet. Command/function is ignored. 
EP1= 64/100. ADVANCE MEDIA command. 
EP1 = OA/10. Manual Media function or SET FORM LENGTH command. 
42 66. | Illegal Macro Command Usage 
ce A macro definition contains an illegal command as shown below. Command is ignored and macro 
definition continues. 
EP1 = 7B/123. READ MACRO STATUS command. 
EP1= 7C/124. SET AUTO MACRO command. 
EP1= 70/125. DELETE MACRO command. 
or 
An END MACRO DEFINITION command is received without a preceeding BEGIN MACRO DEFINITION 
command. Command is ignored. 
EP1 = 79/121. END MACRO DEFINITION command. 
43 67. | Macro Calls Itself 
While expanding a macro, an EXPAND MACRO command is encountered which references a macro 
already partly expanded. The command is ignored and the macro expansion continues. 
EP1 = The number of the partially expanded macro. 
44 68. | Integer Outside Legal Range 
One of the following groups of commands contains a numeric argument which is outside the defined 
range for the command. The number may be expressed in any numeric form. The legal argument 
ranges, the error parameters saved, and the resultant command action are different for each command 
and are summarized in Table J-3. Some error reports are not unique and must be identified by 
considering the commands currently in use. 
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HEX | DEC | DESCRIPTION (Nonfatal Errors) 
— 








45 69. | Too Many Entries or String Too Long 





One of the following commands which cause either several numeric values or string characters to be 
stored has overflowed the allocated storage space. 


@ SET SIGNATURE CHARACTER command. 
Storage size = 1. For strings larger than one character, the first character is used. One error 
reported on last character. 


EP1= 9B/1565. 


@ SET BYPASS CANCEL CHARACTER command. 
Storage size = 1. For strings larger than one character, the first character is used. One error 
reported on last character. 


EP1= AC/172. 


@ SET PROMPT STRING command. 
Storage size = 4. For strings larger than four characters, the first four characters are used. One 
error reported on last character. 


EP1 = FD/253. 


@ BEGIN CHARACTER DEFINITION command. 
Storage size = 1. Definition continues for first string character. One error reported on first 
character. 


EP1= 56/86. 
EP4= Current font number. 
EP5= First string character (ADE Value). 


@ SET DASH PATTERN command. 
Storage size = 20. More than 20 dash pattern elements have been received. First 20 patterns are 
saved and one error reported for each additional pattern element. 


EP1= Current dash pattern element value (0-255). 
46 70. | Unused 
47 71. Unidentified Interface Command Error 














The current command code is not recognized as a Plotter command. The command and any following 
arguments are discarded. 


EP4= First unrecognized command code character (ADE value). 
EP5 = Second unrecognized command code character (ADE value — if the first command code 
character is A, B, C, or D), otherwise EP5 is undefined. 


48 72. [Invalid Command for Selected Output Format 


The current command generates output which cannot be encoded for transmission using the current 
Command/Response Format. The command is discarded. 


EP1 3F/63. READ VIEWPORT command. (2 errors indicated) 
EP1= 62/98. READ MACRO STATUS command. (1 error/macro indicated) 
EP1= 62/98. READ FORM LENGTH command. 


lf a READ ERROR command response cannot be encoded, no error is reported and no output is 
generated. 
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HEX | DEC 


ERROR TYPES 





DESCRIPTION (Nonfatal Errors) 





49 








73. 


Scale =0 








If an argument of a SET ALPHA SCALE command is 0, the corresponding scale value is set to a small 
positive value and execution continues. Also, if an argument of a previous SET ALPHA SCALE 
command was 0, each time an attempt is made to print an alpha character, this error is reported, the 
corresponding scale value is set to a small positive value, and the character is printed. In both cases, 
one error is indicated for each O scale argument. 








4A 


74. 


Viewpoint of O Length or Outside Page Boundary 








4B 





lf a Viewport specification set either by the SET VIEWPORT command or by the front panel Set 
Viewport function results in a Viewport axis of O length, the axis is set to a small positive length and 
execution continues. If any specified Viewport axis end point is outside the Page boundary, the point is 
collapsed to the Page boundary, the affected axes are set to a small positive length (if the collapsed 
axis length is negative or 0), and execution continues. One error is indicated for each affected axis. 











75. 


Window Less Than or Equal to 0 





lf any Window axis length specified by a SET WINDOW command is less than or equal to 0, the axis is 
set to a small positive value and execution continues. One error is indicated for each affected axis. 


























4c 76. | Page Upper-Right on Top of Lower-Left Position 
If the length of any Page axis specified by a front panel Set Page function is O, the axis is set to a small 
positive value and execution continues. One error is indicated for each affected axis. 

4D 77. | Argument Type Error 














An argument for the current command cannot be recognized as the type of argument defined for the 
command. The command and arguments are discarded. 


EP1= Command Code (see below) 

EP4= Received argument type 
01/1. String Argument 
02/2. Numeric Argument 

EP5 = Expected argument type 
01/1. String Argument 
02/2. Numeric Argument 


The command code (EP1) could be one of the following: 





06/6. DRAW (GPIB) command. 

18/24. JOYSTICK AXIS DISABLE command. 
1F/31. MOVE (GPIB) command. 

21/33. SELECT PEN command. 

22/35. BLOCK END (Serial) command. 

2E/46. SET VIEWPORT command. 

2F/47. SET WINDOW command. 

30/48. SET TRANSLATION command. 

31/49. SET SKEW command. 

32/50. SET ALPHA ROTATION command. 
33/51. SET ALPHA SCALE command. 

37/55. SELECT COORDINATE TYPE (GPIB) command. 
3E/62. SELECT CLIPPING CONTROL command. 
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HEX | DEC | DESCRIPTION (Nonfatal Errors) 

——~ 
43/67. SET CHARACTER X-EXTENT command. 
47/71. OPERATOR DIGITIZE ENABLE (GPIB) command. 
49/73. CHARACTER MOVE command. 
4A/74. SELECT GRAPHIC UNITS (GPIB) command. 
4A/74. SET ALPHA DIMENSION command. 
4B/75. SET ALPHA SIZE command. 
4C/76. SET ALPHA RATIO command. 
4D/77. SET TAB SEPARATION command. 
4E/78. SET ALPHA MARGIN SEPARATION command. 
A4F/79. SET ALPHA SCALE command. 
50/80. READ STATUS (GPIB) command. 
50/80. SET ALPHA ROTATION command. 
51/81. SET ALPHA SLANT command. 
52/82. SET ALPHA STANDARD FONT command. 
53/83. SELECT COMMAND/RESPONSE FORMAT (GPIB) command. 
53/83. SELECT ALTERNATE ALPHA FONT command. 
54/84. SELECT ALPHA SPACING CONTROL command. 
56/86. BEGIN CHARACTER DEFINITION command. 
57/87. DELETE FONT DEFINITION command. 
58/88. DELETE CHARACTER DEFINITION command. 
59/89. SET DOWNLOADED CHARACTER SIZE command. 
5C/92. DEVICE RESET (GPIB) command. 
63/99. SET FORM LENGTH command. 
64/100. ADVANCE MEDIA command. 
65/101. SELECT DEVICE UNITS (GPIB) command. 
67/103. SET DASH PATTERN command. 
68/104. SET DASH PATTERN LENGTH command. 
69/105. SELECT LINE TYPE command. 
6E/110. AXIS command. 
72/114. SET ARC SMOOTHNESS command. 
78/120. BEGIN MACRO DEFINITION command. 
TA/1 22. EXPAND MACRO command. 
7C/1 24. SET AUTO MACRO command. 
7D/1 25. DELETE MACRO command. 
80/1 28. BLOCK END (GPIB Format 7) command. 
80/1 28. READ STATUS (GPIB Format 7) command. 
80/1 28. SET BLOCKSIZE (GPIB Format 7) command. 
80/1 28. SET BYPASS CANCEL CHARACTER (GPIB Format 7) command. 
80/1 28. SET PROMPT STRINT (GPIB Format 7) command. 
80/1 28. SET SIGNATURE CHARACTER (GPIB Format 7) command. 
80/1 28. SET TURNAROUND DELAY (GPIB Format 7) command. 
BC/188. SELECT COMMAND/RESPONSE FORMAT (Serial) command. 
DA/218. OPERATOR DIGITIZE ENABLE (Serial) command. 
DD/221. = DRAW (Serial) command. 
E0/224. ¢« MOVE (Serial) command. 
E3/227. SELECT COORDINATE TYPE (Serial) command. 
E6/230. SELECT DEVICE UNITS (Serial) command. 
E9/233. SELECT GRAPHIC UNITS (Serial) command. 
EC/236. DEVICE RESET (Serial) command. 
F2/242. READ STATUS (Serial) command. 
F5/245. SET TURNAROUND DELAY (Serial) command. 
FB/251. SET BLOCK SIZE (Serial) command. 

J-8 4663 PROGRAMMER’S REFERENCE 








| 


6.4 


| 


ERROR TYPES 




















HEX | DEC | DESCRIPTION (Nonfatal Errors) 
aad 

4E 78. | Unused 

4F 79. | Output Value Range Error 





A response value generated by a DIGITIZE command or an Operator Digitize Point function cannot be 
encoded in the packed binary output format because of its value (value limits for this format are 0 to 
4096). The value is clipped to the nearest limit. 


EP1= 5A/90. DIGITIZE command. 
EP1= 5B/91. Operator Digitize Point function. 





50 80. | Illegal Downloadable Character Command 





be 


A command other than SET CHARACTER X-EXTENT, MOVE, DRAW, DRAW CIRCLE, DRAW ARC, or 
SELECT NONADVANCING CHARACTER was received within a character definition. The command is 
discarded and the partial character definition is deleted. 





51 81. 


Illegal Downloadable Character Command Usage 





One of the following commands was received when a downloadable character definition was not in 
process. The command is ignored. 

EP1= 43/67. SET CHARACTER X-EXTENT command. 

EP1= 44/68. SELECT NONADVANCING CHARACTER command. 

EP1= 45/69. END CHARACTER DEFINITION command 











80 128. 





Invalid Switch Entry 





A Parameter Entry Module switch was pushed while the card was fully inserted. 








81 129. | Battery Backup RAM Checksum Error 








A powerup checksum check of the contents of the memory in the Parameter Entry has failed. Possible 
low battery or other hardware problem. All Parameter Entry Card selections should be verified. ‘ 








82 130. 











——+ 


Transform Stack Overflow or Underflow 
A RESTORE PREVIOUS TRANSFORM command was executed without a corresponding preceeding 
SAVE CURRENT TRANSFORM command. Processing continues utilizing the current transform values. 
or 


A SAVE CURRENT TRANSFORM command was executed with insufficient memory available to store 
the transform values. The store is not done and processing continues. 





83 131. 


Transforming Cannot Produce Virtual Digitizing Data Due to Transform Values 








If the sum of the two axis skew values specified in a SET SKEW command is 90 or 270 degrees, 
subsequent Digitize or front panel Point functions cause this error to be generated. Output values are 
generated but they are only partially processed and are invalid. 





84 132. 


RAM Verify Error 











One or more blocks of 64 bytes failed the powerup RAM test and was masked as unavailable for users. 
This error indicates a hardware problem. EP2 and EP3 contain the beginning address (high byte and 
low byte respectively) of the last bad block. 
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HEX 


DEC DESCRIPTION (Nonfatal Errors) 








85 


= 
133. 


Insufficient Memory for Buffer Allocation 





86 134. 


Insufficient memory exists to complete the storage of a programmable macro or a downloadable 
character. If a programmable macro definition cannot be completed, then the partial definition is 
deleted. The definition of a downloadable character is a two stage process: First, the character is 
defined, and secondly, the font containing the updated character is recorded in the font directory. If 
memory is exhausted during the character definition, the partial character is deleted. If insufficient 
memory is available to record the updated font (in the font directory) the entire font is deleted. 


If the error parameters contain one of the following values, the overflow occurred during a 
downloadable character definition. 


EP1 = 
EP1 = 
EP4 
EP1 
EP1 
EP1 
EP1 = 
EP1 = 
EP1 = 


EP4 = 
EP5 = 


i 


ll 


i 


56/86. BEGIN CHARACTER DEFINITION command. 


59/89. SET DOWNLOADED CHARACTER SIZE command. 


45/69. END CHARACTER DEFINITION command. 
43/67. SET CHARACTER X-EXTENT command. 


44/68. SELECT NONADVANCING CHARACTER command. 


34/52. MOVE command. 

35/53. DRAW command. 
74/116. DRAW ARC command. 
75/117. DRAW CIRCLE command. 


Current font number. 
Current character being defined (ADE value). 


lf the error parameters contain the following values, then the overflow occurred during a programmable 
macro definition. 


EP1= 
EP2= 
or 
EP2= 
or 
EP2= 


Current macro number 
58/88. and EP3 = 55/85. (Macro too large) 


5C/92. and EP3 = B7/183. (Insufficient storage to begin definition) 


5D/93. and EP3 = 5B/91. (Macro too large) 








Cannot Find Specified Macro 





TA macro specified by either the EXPAND MACRO command or the SET AUTO MACRO command is not 


currently defined when an attempt was made to expand the macro. The command is ignored. 





















































EP1 = Non-existant macro number. 
87 135. | Illegal Alpha Table Command Type 
bE 
An unrecognizable encoded command byte was read from a stored alpha character definition. Drawing 
| of the character is aborted. 
88 136. | Unused 
89 137. | Illegal Monitor Usage 
— —t 
Current Plotter internal processing has produced unexpected status. The current processing is 
aborted and command execution continues. 
8A 138. | Output Processing Routine Missing 
iT 
The output encoding routine referred by an output generating command cannot be located. The 
command is aborted. 
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HEX | DEC | DESCRIPTION (Nonfatal Errors) 
8B 139. | Number Greater Than 99999.996 in Fixed ASCII Conversion 
One or more of the coordinates generated by a DIGITIZE command or an Operator Digitize Point 
function has a value greater than 99999.996 and the output format is fixed point ASCII decimal. The 
value is clipped to 99999.996 and execution continues. 
8C 140. | Too Many PROM Alpha Tables in System 
At powerup more than two optional alpha tables were encountered. Additional tables are ignored. 
8D 141. | Selected Interface Hardware or ROM Not Present 
The hardware and/or firmware to be activitated by a Parameter Entry Card selection made on the 
Interface Select line is not present. 
Table J-3 
INTEGER OUTSIDE LEGAL RANGE 
Legal Error Parameters 
Command Range 1 2 = Comments 
——1 1S a6 
AXIS 3.0 6E/110. none none Error if < 0. Command ignored. 
BEGIN CHARACTER DEFINITION 0-15 56/86. 55/85. 8A/138. Command and following character defini- 
tion is ignored? 
BEGIN MACRO DEFINITION 0-255 78/120. 5C/92. 94/148. Command and following macro definition is 
ignored. 
BLOCK END 0-4095 23/35. none none Clips checksum to nearest limit. Causes 
checksum error and continues. 
DELETE CHARACTER DEFINITION | 0-15 58/88. 57/87. 3C/60. Command ignored? 
DELETE FONT DEFINITION 0-15 57/87. 57/87. 7C/1 24. Command ignored 
DELETE MACRO ft 0-255 7D/125. 5F/95. BE/190. Command ignored. 
DEVICE RESET 0-1 01/1. C6/198. AA/170. Command ignored. 
DRAW See footnote b. 
DRAW ARC See footnote b. 
DRAW CIRCLE See footnote b. 
EXPAND MACRO 0-255 TA/1 22. 5E/94. 7F/127. Command ignored. 
JOYSTICK AXIS DISABLE 0-3 none A7/167. D3/211. Command ignored. 
MOVE See footnote b. 
PRINT 47/71. See footnote b. 
PRINT CENTERED 148/72. See footnote b. 
READ STATUS 0-7 03/3. C7/199. 7B/171. Serial Formats 1-2 and GPIB Formats 1-4. 
Sets value to O and continues. 
0-15 03/3. C7/199. 7B/171. Seria! Formats 3-4 and GPIB Formats 5-6. 
Sets value to 0 and continues. 
SELECT ALPHA O-1 54/84. 94/148. 85/133. Command ignored. 
SPACING CONTROL 
SELECT ALTERNATE 0-15 §3/83. 94/148. 5F/95. Command ignored. 
ALPHA FONT 
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ERROR TYPES 
Table J-3 (cont) 
INTEGER OUTSIDE LEGAL RANGE 
Legal Error Parameters 
Command Range 2 3 Comments 
SELECT CLIPPING CONTROL 0-1 | 3E/62. BA/186. 09/9. Command ignored. 
SELECT COMMAND/ 1-4 none E9/233. 26/38. For arguments < O and > 4. Command 
RESPONSE FORMAT Serial ignored. 
- —_— a 
1-4 BC/188. none none For arguments = 0. Command ignored. 
Serial 
1-7 none EA/234. 4A/74. For arguments < 0 and > 7.Command 
GPIB ignored. 
| 1-7 53/83. none | none For arguments = 0. Command ignored. 
GPIB 
SELECT COORDINATE TYPE | 0-1 none EA/234. 78/120. Serial, Command Ignored. 
| O-1 none E9/233. | 94/148. | GPIB, Command Ignored. 
SELECT DEVICE UNITS 0-2 none EA/234. 8B/139. Serial, Command Ignored. 
0-2 none E9/233. | C5/197. | GPIB, Command Ignored. 
SELECT GRAPHIC UNITS 0-1 none EA/234. B7/183. Serial, first argument command ignored. 
0-1 none E9/233. FD/253. GPIB, first argument, command ignored. 
0-1 40/64. BD/141. 3E/62. Second arguments: Input graphic units 
} changed — output graphic units not 
changed. 
SELECT LINE TYPE 0-3 69/105. 80/128. ED/237. Command Ignored. 
SELECT PEN 0-255 21/33. J A7/167._| 98/152. _| Command Ignored. 
—— 
SELECT STANDARD 0-15 52/82. 94/148. 5F/95. Command ignored. 
ALPHA FONT 
SET AUTO MACRO 0-255 7C/1 24, | 58/88. DO/208. Command ignored. 
SET BLOCK SIZE 0-65535 FB/251. none none | Clips blocksize to nearest limit and contin- 
| ues. 
SET BYPASS CANCEL AC/172. See footnote a. 
CHARACTER 
SET DASH PATTERN 0-255 67/103. 81/129. 1A/26. Pattern element is set to 255 (MAX dash) 
zi and continues. 
SET DOWNLOADED 0-15 59/89. 54/84. (EEA Fe Command ignored. 
CHARACTER SIZE 
SET FORM LENGTH A 0-65535 | 63/99. 8F/143. 4B/75. Command ignored. 
SET PROMPT STRING FD/253. See footnote a. 
SET SIGNATURE CHARACTER asl 9B/155. See footnote a. 
SET TURNAROUND DELAY 5 0-65535 | F5/245. none none Clips delay to nearest limit and continues. 
—L 











31¢ the /number” form of string arguments is used, and if the numeric argument range is less than O or greater than 255, then a value of 0 is assumed and execution 


continues. 


Dit a numeric argument for these commands (when used in a downloadable character definition) has a value outside the following ranges, then an undefined error is 


generated, the command is discarded, and definition of the downloadable character continues: 


@ xmin-64 TO xmin+175 (for x arguments or circle radius arguments) 
@ ymin-64 TO ymin+175 (for y arguments) 
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ERROR TYPES 


FATAL ERROR CAUSES/RESPONSES 


The following listing describes error parameters for each fatal error detected by the Plotter. 



































At power-up, specific RAM locations (the first location in each 1k byte block of memory, starting at 0) 
are scanned for read/write function to determine available memory. This error is issued if less than 3K 
bytes of RAM exist (which is the minimum amount required for useful operation). Error parameters are: 


EP2= Address high byte of the beginning of the last 1K byte block of functional RAM. 
EP3= Address low byte of the beginning of the last 1K byte block of functional RAM. 











HEX DEC | DESCRIPTION (Fatal Errors) 
01 ‘Le Insufficient RAM 
02 2. RAM Check Error 


03 : ROM Check Error 


04 




















This error indicates a failure of a RAM test performed at powerup on the minimum amount of RAM 
required for useful operation (3K bytes starting at 0). Error parameters are: 


EP1= The bit pattern which failed to store. 
EP2= Address high byte of the bad location. 
EP3= Address low byte of the bad location. 

















This error indicates that a powerup checksum test has failed on one of the system ROMs. Error 
parameters are: 
EP1 Starting address high byte of the ROM being tested. 


EP2= Checksum high byte of the ROM being tested. 
EP3 = Checksum low byte of the ROM being tested. 








Undefined Common Subroutine 


During operation, a firmware subroutine was referenced that had not been defined at power-up. This 
error indicates one of the following: 








® Modified firmware has referenced a nonexistant subroutine, 

® Asystem ROM was missing or not accessible during powerup, or 

@ ARAM failure occurred which caused the address of a common subroutine defined at powerup to 
be lost. 
Error parameters are: 


EP2= Address high byte of the ROM where subroutine was called from. 

EP3= Address low byte of the ROM where subroutine was called from. 

EP4= Address high byte of the RAM where the subroutine starting address was expected. 
EP5 = Address low byte of the RAM where the subroutine starting address was expected. 
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HEX | DEC | DESCRIPTION (Fatal Errors) 














05 5. Command Dispatch Error 





An invalid service routine start address, interrupt level identifier, Parameter Entry Card line identifier, 
or command code was encountered at powerup. This error indicates one of the following: 


@ Modified firmware which references a service routine incorrectly. 
@ A ROM access failure which causes a service routine to be incorrectly defined. 
Error parameters are: 


EP1= Thecurrent interrupt level identifier, the current Parameter Entry Card line identifier, or the 
current command code. 

EP2= Address high byte of the ROM where the service routine was incorrectly defined. 

EP3= Address low byte of the ROM where the service routine was incorrectly defined. 

or 

EP2= High byte of bad service routine vector. 





06 6. Software Interrupt 





An unexpected software interrupt has occurred. Software interrupts are not used for normal system 
operation. 





07 7. 





Nonmaskable Interrupt 


+— —+— 





An unexpected non-maskable interrupt has occurred. Non-maskable interrupts are not used for 
normal system operation. 





08 he: 


Nonexistant Memory Reference 





cl 9. 


This error indicates that a system processor tried to read or write to a hardware address which did not 
respond causing the system bus to time out. Either the hardware at that address failed, or a a system 
failure caused an undefined address to be generated. Error paraemters are: 


EP2= Address high byte of the location following the instruction that the processor was executing 
when the bus timed out. 

EP3= Address low byte of the location following the instruction the processor was executing 
when the bus timed out. 


Unable to Create a Buffer (Insufficient RAM) 























Insufficient RAM was found during power-up to allow the creation of a system buffer. 
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HEX | pec DESCRIPTION (Fatal Errors) 








OA 10. | Unexpected System Error 








This error indicates a condition that could be detected by the firmware but was not expected to occur 
during normal operation. Because the error was not expected, appropriate assumptions could not be 
made and processing was halted. The following group of errors lists the activities when an Unexpected 
System Error could be detected. 


EP2= 57,EP3= 1E A currently defined Option 32 font buffer was being searched for a 
specified character, and a Font O marker was followed by a character count of 0. 


EP2= 50,EP3= 50 An Option 32 character stroke load/unload pointer is outside the stroke 
buffer area. 


EP2= AA,EP3= 27 Undefined internal motion command restart status found. 


EP2= AA,EP3= 57 Undefined internal motion task code read from motion task buffer. EP1 
contains the task code. 


EP2= AC,EP3= BD Unexpected internal motion command buffer full when entering internal 
motion command. — OR — Unexpected internal motion task buffer empty when reading an 
internal motion task. 


EP2= B9,EP3= E4 Unexpected stack overflow while pushing transform bytes into the 
transform stack. 





EP2= CA,EP3= EA Unexpected buffer overflow while entering command restart request. 


EP2= E4,EP3= 98 Unexpected output data buffer empty while transmitting an output 
message. 


EP2= E9,EP3= 2F Unexpected buffer overflow while entering a command into the input 
command buffer. 


EP2= F5,EP3= 09 Unexpected underflow while reading an address from the command 
restart buffer. 
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| 

HEX | DEC | DESCRIPTION (Fatal Errors) 

—> 

OB 11. | No Service Routine for Level 

—_—}—____} 
A hardware interrupt has occurred which is assigned to a particular firmware interrupt priority level 
where no service routine is currently defined. This error is also generated if the DATA CARRIER 
DETECT line (of the RS-232-C interface) is “glitched” while the Plotter is transmitting. 
—_ 
OC /| 12. | No Self-Interrupt Routine for Level 





The firmware has requested an internal self interrupt for which no service routine is defined. 





















































OD 13. | MSync Address Not in First 256 Bytes of ROM 
T 
An illegal motion synchronization address was encountered. 
OE 14. | No Routine for Specified System Command 
An internal Plotter command has been encountered for which a processing routine is not currently 
defined. 
OF 15. | ROM in Wrong Socket 
pes 
A non-relocatable ROM was found (during powerup) at an address which does not agree with the 
location-dependant firmware contained within the ROM. Error Parameters are: 
EP1= Address high byte where the ROM firmware should begin. 
EP2= Address high byte of a location less than 256 bytes from where the ROM firmware actually 
begins. 
EP3= Address low byte of a location less than 256 bytes from where the ROM firmware actually 
| begins. 
10 16. | Motion Buffer Overrun 
| 
Unexpected internal motion task buffer full when entering an internal motion task. 
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HEX | DEC | DESCRIPTION (Fatal Errors) 
11 17. | Unexpected Buffer Overflow/Underflow 
This error indicates that a buffer overflow/underflow condition has been detected. This fatal error 
occurs if firmware determines that space exists, but later an overflow occurs. The error also occurs 
when firmware determines that data exists, but later an underflow occurs. The following groups of 
errors list activities when an Unexpected Buffer Overlow/Underflow error could be detected: 
@ ERRORS RELATED TO OPTION 31 OPERATION 
EP1= Command code of Option 31 related command being processed. 
EP2= 58,EP3= 74 Memory overflow while trying to enter a command byte into the current 
macro buffer. 
EP2= 5D,EP3= 72 Memory overflow while trying to: 
— Create a one block macro buffer for a new macro. 
— Enter the macro number into a new macro buffer. 
— Clear the header in a new macro buffer. 
— Enter a new macro list termination byte. 
EP2= 5E,EP3= 70 Memory overflow while trying to record the macro in the macro list. 
EP2= 5F,EP3= E9 Memory overflow while trying to enter a macro list termination byte after a 
macro delete. 
EP4orEP5 The number of the current macro being processed. 
@ OUTPUT RELATED ERRORS 
EP2= 7E,EP3= 48 _ The output data buffer overflowed during loading of output block. EP1 
contains the number of bytes previously written. 
7 @ ERRORS RELATED TO OPTION 32 OPERATION 
EP1 = Command Code of current Option 32 command being processed. 
EP2= 53,EP3= 8A Memory overflow while trying to record an Option 32 font in the font list. 
EP2= 52,EP3= 95 Memory overflow while trying to enter a new Option 32 font list 
termination byte. 
EP2= 53,EP3= BC Memory overflow while trying to enter an Option 32 character definition 
byte into the current font buffer. 
EP2= 55,EP3= 2E Memory overflow while trying to enter a new Option 32 font list 
termination byte. 
EP2= 55,EP3= 4D Memory overflow while trying to create a one block Option 32 font buffer 
for a new font. 
EP2= 56,EP3= 09 Memory overflow while initializing the header for a new Option 32 font 
buffer. 
EP2= 57,EP3= B4 Memory overflow while trying to enter an Option 32 font list termination 
byte after a character delete. 
EP3 or EP5 = Current Option 32 font number. 
EP4= Current Option 32 character. 
@ TRANSFORM RELATED ERRORS 
EP2= B9,EP3= E4 Unexpected memory underflow while checking for space to push 
aif transform bytes on the transform stack. 





— 
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GLOSSARY 


address character 
(Serial) The second character of most commands. Can 
be set to ASCII characters A through H. 


ADUs 
Addressable Device Units. One of three choices of 
Device Units. 


argument 
A parameter associated with a command (e.g., for the 
angle of rotation or for the X-coordinate of a Move. 


argument separators 

Special character sequences that define the end of one 
argument and the beginning of the next. A space or 
comma character is most often used. 


ASCII character 

One of the 128 characters defined by the ASCII 
(American National Standard Code for Information 
Interchange) standard. 


ASCII Decimal Equivalent (ADE) 
The decimal value associated with ASCII characters 
(e.g., 32 for Sp, 65 for A). 


attention character 
(Serial) The first character of most commands. Can be 


set to ESC, !,A , or SYN using the Parameter Entry Card. 


Attention Action commands 
(Serial) A command consisting of a series of two 
characters beginning with the attention character (47). 


auto move-to-home 

The process of automatically performing a move to the 
home position whenever a PRINT command follows 
power-up, media change, or a front panel Locate 
function without an intermediate Move or Draw. 


baud rate 

(Serial) See receive baud rate or transmit baud rate. 
bit 

A binary digit having two possible values: O or 1. 

1 = true or set while O = false or cleared. 


4663 PROGRAMMER'S REFERENCE 


block 
(Serial) Formatted group of commands or responses. 


Block mode 
(Serial) A procedure for block Serial communications. 


block size 
(Serial) The size (in characters) of a Block mode block. 


byte 
A group of eight bits. 


character argument 
A command argument consisting of a single ASCII 
character. 


character x-extent 
The left and right coordinates that specify the left and 
right edges of a printing character. 


checksum 

(Serial) Part of a Block mode block. Determined by 
summing the contents of the block used to detect 
transmission errors. 


clipping 
The process by which the portion of a plot that falls 
outside of a specified boundary is not plotted. 


command code 
One or two ASCII characters that uniquely identify a 
command. 


command syntax 

The conventions for a particular application (such as 
Serial, GPIB, or 4050 Series BASIC) that defines how 
to form a command. 


command terminator 
A character that marks the end of the command. See 
discarded terminator and reprocessed terminator. 


Command/Response Format 

The selection made on the Initial Command/Response 
Format line of the Parameter Entry Card that configures 
either the Serial or GPIB interface to accept commands 
and send responses in a specified format. 


GLOSSARY 


coordinate 
The X-axis and Y-axis values used to describe a point. 


crosshair cursor 
The plastic sight located on the pen carriage. 


DAB command 

(GPIB) A command consisting of data bytes froma 
controller that contains the command code and argu- 
ments. 


delimited string 

A sequence of ASCII characters beginning and ending 
with a closing single quotation mark (’), an opening 
double quotation mark (‘‘), or a slant character followed 
by a character ADE value. Longer strings can be 
formed from strings of this form. 


device coordinate system 

A Cartesian coordinate system for the Page. The origin 
is the lower-left Page corner. (See Device Units for 
additional details.) 


device status 
See status information. 


Device Units 

One of three sets of numerical values assigned to the 
Initial Page for the Device Coordinate System. The 
default selection will be ADUs for a Serial interface and 
GDUs for a GPIB interface. The range of values will be 
4096 along the long axes for ADUs, 100 along the short 
axis for GDUs, or directly in millimeters for mms. Both 
axes will have physically identical unit size. See 
Section 1 for more information. 


digitizing 
The process of locating and transmitting the coordinate 
information to the host. 


discarded terminator 

A terminator that explicitly delimits the command. Once 
recognized, these terminators are discarded without 
further interpretation. 


downloaded character 
(Requires Option 32) A definition of how a specific 
alphanumeric character or symbol is to be printed. 
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Draw 
The Plotter draws a line to a specified position. 


EO! (End Or Identify) 

(GPIB) This bus message is sent with the last data byte 
of a message, indicating that the message is complete 
and terminating the last command in the message. 


error codes 

Occurrence of errors is reported by a flashing or 
steady Reset light and by sounding the bell. Lights on 
the Parameter Entry Module (with the Error Data line 
selected) can be interpreted as an error code to 
determine the source of the error. Refer to Appendix J 
for more information. 


escape sequence 
(Serial) Same as an Attention Action command with the 
specific attention character of c. 


fatal error 

A detected error serious enough that all plotting is 
halted. The Reset light will be on steady. (See nonfatal 
error.) 


font 
A set of one or more character definitions for print 
actions. 


form length 
(Requires Option 36) The length of media advanced 
during a Media Change function. 


full duplex 
Allows communication in two directions at the same 
time. 


GDUs 
Graphic Device Units. One of three choices of Device 
Units. 


GPIB 

Abbreviation for General Purpose Interface Bus. Used 
in reference to interface or interface-dependent char- 
acteristics. 


home position 

A point located one character height below the upper- 
left corner of the Viewport along a line perpendicular to 
the current printing position. 
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Initial Page 

One of several predefined Pages (including the user- 
defined selection) that is established by Parameter 
Entry Card selections. See Section 1 for additional 
information. 


Initial Viewport 

The Viewport that corresponds to the Initial Aspect 
Ratio line selection on the Parameter Entry Card. See 
Section 1 for more information. 


Initial Window 

A Window that corresponds to the Initial Viewport. An 
Initial Window exists for each of the three Device Units 
selections of ADUs, GDUs, and mm’s. See Section 1 
for more information. 


Initialize function 

This front panel function resets the active interface 
after communications with the host or controller have 
been lost. However, it does not modify any of the 
current programmable interface parameters (such as 
prompt character, signature character, turnaround- 
delay time, etc.). 


input buffer 

Refers to the memory of the Plotter that permits 
incoming commands to be temporarily stored until the 
Plotter can generate the corresponding Plot actions. 


line type 

Refers to either solid, fixed dash-pattern-length, vari- 
able dash-pattern-length, or point (the plotting of 
endpoints for each line segment) methods of drawing 
lines with the Plotter. 


listener 
(GPIB) A device that receives commands being 
transmitted over the GPIB interface. 


loop-thru 

(Serial) A scheme where the Plotter is inserted into the 
normal communication path between two pieces of 
equipment, such as a computer or modem and a 
computer terminal. 


macro 
(Requires Option 31) A group of Plotter commands that 
can be stored in the Plotter and later executed by a 
single command. 
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media 
The paper, mylar, etc. upon which a plot is drawn. 


MLA (My Listen Address) 
(GPIB) The device address that enables the Plotter to 
be a listener. 


Move 
The pen carriage is moved to a specified position 
(without the pen contacting the media). 


MSA (My Secondary Address) 

(4050 Series BASIC) A method of specifying command 
codes with a nonstandard use of the GPIB MSA 
message unique to the 4050 Series Graphic System. 


MTA (My Talk Address) 
(GPIB) The device address that enables the Plotter to 
be a talker. 


nonfatal error 
A detected error that is reported (Reset light flashes), 
but does not halt plotting operation. 


NULL arguments 

An argument either of zero value (for NULL numeric 
arguments) or consisting of the single ASCII character 
Nu (for a NULL string argument). NULL argument values 
are established by simply not specifying the argument 
and including only the argument separator (or termina- 
tor). 


numeric argument 

A numeric argument expressed in one of three stan- 
dard forms: integer, floating point, or scientific notation 
(E format). 


output block 
A portion of an output response containing one or three 
values. 


output message 

A transmission from the Plotter consisting of one or 
more output blocks in response to a specific host 
command. 


output responses 
Information sent by the Plotter in response to com- 
mands. 
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output terminator 
(Serial) A character sent following an output message 
transmitted by the Plotter. 


padding 

(Serial) The process of intentionally limiting the 
average rate of information transfer by inserting extra 
characters that will be ignored. 


Parameter Entry Card 

A directory (part of the Parameter Entry Module) that 
assists the user in selecting the Plotter’s operating 
parameters. 


Parameter Entry Module 
That portion of the Plotter that includes the Parameter 
Entry Card, the INIT light, and the lighted switches. 


Page 
A rectangular area on the platen that can be used for 
plotting. 


pen Carriage 
The part of the Plotter that includes the crosshair 
cursor, Pen Holder 1, and Pen Holder 2. 


platen 
The flat surface upon which the media is placed. 


platen clipping boundary 
The border outlining the maximum area on the platen 
that is available for plotting. 


plot 
Refers to the composite line and character information 
drawn on the media. 


plot time 
See accumulated plot time. 


Point Plot mode 

This mode saves the current line type and then 
establishes point as the current line type (causing a 
dot to be placed at each specified plot coordinate). The 
next time Graph mode is entered, the previously saved 
line type is restored. 


primary address 
(GPIB) A number assigned to each device on the GPIB 
bus. The Plotter’s primary address is selected by the 


GPIB Device Address line on the Parameter Entry Card. 
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prompt string 

(Serial) A sequence of ASCIl characters that must be 
received by the Plotter before any output is transmitted 
to the host. 


receive baud rate 
(Serial) The rate at which information can be received 
by the Plotter. 


reprocessed terminator 

These terminators end a previous command, but are 
also used as part of the next command (such as when 
the 4t character for a command terminates the previous 
command). 


response block 

A grouping of information, ranging from 7 to 33 
characters in length, that consists of two data values 
and a TAG value. 


RS-232-C 

(Serial) An industry standard for the interface between 
data terminal equipment and data communication 
equipment employing serial binary data interchange. 


secondary address 
(GPIB) See MSA. 


Serial interface 

Refers to the RS-232-C interface or characteristics 
associated with that interface. The interface transmits 
and receives ASCII characters composed of individual 
bits transmitted one bit at a time (i.e., serially). 


signature character 

(Serial) A unique character optionally sent as the first 
character of each Plotter output block. This character 
can be used to identify a specific Plotter when more 
than one Plotter is connected to the host. 


status information 

All or part of the internal Plotter information (such as 
out-of-media or active pen selection) that the Plotter 
can send on request to describe its current state. 


string arguments 
A sequence of one or more ASCII characters. See 
delimited string and undelimited string. 


Style | commands 
Unique Plotter commands that use ASCII decimal 
coding. 


4663 PROGRAMMER’S REFERENCE 


~ 


— 


Style Il commands 
Plotter commands that use binary data coding. Used 
with TEKTRONIX 4010 Series terminals. 


syntax 
See command syntax. 


TAG value 
A third numeric value sent with response values in 
most output blocks. 


talker 
(GPIB) A device that transmits information on the GPIB 
bus to other specified devices. 


terminator 
See command terminator. 


transform commands 
Commands that modify incoming data to the Plotter. 


transmit baud rate 
(Serial) The rate at which information is transmitted by 
the Plotter. 


turnaround delay 

A function that delays Plotter transmissions for a set 
time after host/controller information has been re- 
ceived by the Plotter. 
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undelimited string 

A sequence of ASCII characters where the first charac- 
ter cannot be a slant, apostrophe, or quote mark; the 
string cannot begin with or include a comma, §p, "1, 93, 
Ny, Sy, °. (if DEL IGNORE is selected), ©r, 41, or 
semicolon (if Command/Response Formats 1 and 2). 
Command/Response Formats 3 and 4 limit the string to 
a single character. 


Viewport 
The rectangular portion of the Page onto which the plot 
is drawn. 


Window 
The rectangular portion of the World Space that is 
projected onto the Viewport. 


World Coordinate System 
A two-dimensional Cartesian coordinate system for 
World Space. 


World Space 

The space associated with the object or picture. World 
Space can include graphs, maps, mechanical drawings, 
or other pictures. 


World Units 
Units for the World Coordinate system. 
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Appendix L 


COMMAND INDEX 


Command Page 
ADVANGE MEDIA. 3 5: ecousnevinswmet a esece 16-5 
BRIS cise eer ores Oro eae aie: 11-25 
BEGIN CHARACTER DEFINITION ........... 15-9 
BEGIN MACRO DEFINITION ................ 14-5 
BLOCKIEND) wore oe th aa anaes date te 7-5 
BEOCKISTARM: .xwur yiiec wasn laamenconenton 7-4 
ALIS DIGIMIZ Es araus: a trear sacra teen etree 13-12 
CHARACTER MOVE ........ 000 cneseceenenes 10-26 
DATAIRESEN Sure rst arias oe brane ee 7-12, 8-2 
DELETE CHARACTER DEFINITION.......... 15-13 
DELETE FONT DEFINITION ................. 15-14 
DEEETEIMACRO incon. What ast eure nae 14-8 
DEVICE ORR sit ee ores ree er meres 7-3 
DEVICE ION viet scien a ne es acerca wc 7-2 
DEVI CERESET teengtce nant mers aoe anes 9-2 
DIGITIZE nat tn teen conch chen cahas arabs now 13-8 
BRA besten cee eee moncre eae eer ar tet ee 11-20 
DRAW ARG Gia scccmn terse eics Mas ameamaamin 11-28 
DRAW: GIRGUE: an Secs ods ax crys sed oa las as wees 11-29 
END CHARACTER DEFINITION.............. 15-10 
END MACRO DEFINITION.................5. 14-6 
EXPAND MAGR®O wis iaieseksngee cig tavte dans 14-7 
IDENTIFY ax etvn sored eae ete eee eerie 9-11 
INTERFACE PARAMETER RESET ........... 7-11, 8-4 
JOYSTICK AXIS DISABLE .................. 13-16 
MARK, VIEWPORT sccce cao. wees oo ome careers 11-24 
MONE. s cach. cb oscar ane tees GEQmes BE aA BaP SS 11-18 
MOVE TOMHOME | wacvdetne ces stertec maar ane 10-25 
MOVE TO LOAD POINT...............-00000: 11-22 
OPERATOR DIGITIZE ENABLE.............. 13-10 
OUTEINE VIEWPOR Tins sexton cies: wee apes vanes 11-23 
PAGE) CHANGE: x 2 sno cave thos trgwierie Sie heya idee wae 16-2 
PRIN ari coon coin cians venient areas 10-22 
PRIN: GENT ERED. aitee re terete tetera ote 10-24 
PROMPT LIGHT OFF 4 acca siced ee aves nacen sas 13-15 
PROMPT LIGHT ON ....cs0: csc erussves ves ve 13-14 
READER ORR sate co tease tron ceneat seers 9-9 
READ FORM LENGTH .................00005 16-4 
READ MACRO STATUS................00005 14-9 
READ SWAT WSic ia teh concert cas-cisod tea meenariear bre 9-4 
READ VIEWPORT ........ 20sec ence nec ee cee eee 11-26 
RESET ALPHA PARAMETER................ 10-21 
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RESTORE PREVIOUS TRANSFORM......... 
SAVE CURRENT TRANSFORM.............. 
SELECT ALPHA SPACING CONTROL ....... 
SELECT ALTERNATE ALPHA FONT......... 
SELECT CLIPPING CONTROL .............. 
SELECT COMMAND/RESPONSE FORMAT .. 
SELECT COORDINATE TYPE ............... 
SELECT DEVICE.UNIT Sic sguceavantomieress 
SELECT GRAPHIC UNITS: ...< cosc sein arse oi oco 
SELECT WINEMIViRE ca vena. cdars arctan cco ncres 
SELECT NONADVANCING CHARACTER..... 
SELECT PEN sie ris chy ice cerc melee cress 
SELECT STANDARD ALPHA FONT.......... 
SET ALPHA DIMENSION). «025065000: seccie cose oie 
SET ALPHA MARGIN SEPARATION ......... 
SET ALPHA RATIO iconcosies aa tesa areveune os we 
SETALPHAVROTATION tice cc 0 muenarece: corn anne 
SEMALPHA: SCALE svat i Geospere cess iaercenracye aun 
SET ALPHA SIZE: css cccacrnienaraesendee: 
SET AEPHA-SLANT .0svencsmideiewt vere vain 
SET ARC SMOOTHNESS ................... 
SET, AUTO:MAGRO) «oie sscc scion arsine entinctin o% 
SEV BLOCK SIZE. os cy onthe bseatinnoauam ens 
SET BYPASS CANCEL CHARACTER ........ 
SET CHARACTER X-EXTENT ............... 
SET DASH PATTERN 5. i.< mre screcinsdinoacieines 
SET DASH PATTERN LENGTH.............. 
\SET DOWNLOADED CHARACTER SIZE...... 
SET FORM LENGTH ssiccgre aes eae nee ie wes 
SET ORIGIN TO CURRENT POSITION ....... 
SET'PROMPT ‘STRING 3 cc cfs are nna ates arenes 
SETIROWATION cc catiactn apie arias atare 
SET ROTATION TO LAST ANGLE ........... 
SET SGALE: ose vce meswesmd ews mts yer aet wie 
SET SIGNATURE CHARACTER.............. 
SETISKEW .2ccs.5 aves satnnamacareteaas 
SET TAB SEPARATION..................05. 
SET: TRANSLATION occ 26 cas cars nmiesae ooe eis 
SET TURNAROUND DELAY................. 
SET: VIEWPORT ce cige'ssue roars ata evens oe aye 
SET WINDOW?! fs. sas: snesuns tien Mes Wowie ome we 
SIZE rac aren siete Sens ela siees eva richer aieine = ke gS 
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accumulated plot time, 9-8 

address character, 4-33, 6-5 

addressable device units, 1-3, 1-8 

ADU, see addressable device unit 

ADVANCE MEDIA command, 16-5 

alpha dimension, see SET ALPHA DIMENSION 
command 

alpha font, see SELECT STANDARD ALPHA 
FONT and SELECT ALTERNATE ALPHA FONT 
commands 

alpha margin separation, see ALPHA MARGIN 
SEPARATION command 

Alpha mode, 4-40 

alpha ratio, see SET ALPHA RATIO command 

alpha rotation, see SET ALPHA ROTATION command 

alpha scale, see SET ALPHA SCALE command 

alpha size, see SET ALPHA SIZE command 

alpha slant, see SET ALPHA SLANT command 

alpha spacing control, see SELECT ALPHA SPACING 
CONTROL command 

alternate alpha font, see SELECT ALTERNATE ALPHA 
FONT command 

arc, 11-5, see also DRAW ARC command 

arc smoothness, 11-5 

arguments, 4-34, 5-18, 6-5 to 6-7 

argument groups, 4-37, 5-20 

argument separators, 4-36, 5-20, 6-3, 6-5 to 6-7 

Attention Action commands, 4-46 

attention character, 4-13, 4-33, 6-5 

auto mute, 4-2 

automatic move-to-home, 10-2 

available memory, 9-7 

AXIS command, 11-25 


baud rate, see receive baud rate and transmit baud rate 

BEGIN CHARACTER DEFINTITION command, 15-9 

BEGIN MACRO DEFINITION command, 14-5 

BLOCK END command, 4-22, 4-27, 7-5 

Block mode, 4-15, 4-22, 4-25, 4-26 

BLOCK START command, 4-22, 4-27, 7-4 

blocksize, 4-23, see also SET BLOCK SIZE 
command 

bypass cancel character, see SET BYPASS CANCEL 
CHARACTER command 

bypass mode, 4-32 
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CALL DIGITIZE command, 13-12 

carrier detect, 4-13 

character format line, 4-11 

CHARACTER MOVE command, 10-26 

checksum, 4-25 

circle, 11-5 

clipping, 1-11 

clipping control, see SELECT CLIPPING CONTROL 
command 

command code, 4-34, 5-18, 6-5 to 6-7 

command interpretation, 4-37, 5-21 

command syntax, 6-4, 6-6, 6-7 

command terminator, 4-36, 5-13, 5-20, 6-3, 6-6, 6-7, 
see also discarded and reprocessed terminator 

Command/Response Format, 4-9, 4-49 to 4-53, 
5-5, 5-6, see also /nitial Command/Response 
Format and SELECT COMMAND/RESPONSE 
FORMAT command 

communications control mode, 4-11, 4-14 

Continuous mode, 4-14, 4-20 

control block, 4-48 

conventions, 6-1, 6-2 

coordinate encoding, 4-40, 4-44 

coordinate resolution, 4-44 

CR generates LF, 4-12 


DAB commands, 5-8, 5-25 

dash patterns, 11-2, 4 

dash pattern length, 11-5 

DATA RESET command, 7-12, 8-2 
DC1/DC3 control, 4-12, 4-31 

DC1/DC3 Flagging mode, 4-15, 4-22 

DEL Ignore, 4-13 

DELETE CHARACTER DEFINITION command, 15-13 
DELETE FONT DEFINITION command, 15-4 
DELETE MACRO command, 14-8 

delimited string, 4-35, 5-19 

Device Clear (DC 1), 5-14 

DEVICE OFF command, 7-3 

DEVICE ON command, 7-2 

DEVICE RESET command, 9-2 

device status, 9-6 

Device Units, 1-3, 1-8, 1-12 

digitizing, 1-12, 5-13, 13-1 to 13-5 
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DIGITIZE command, 13-8 

discarded terminator, 4-36 
downloadable characters, 15-1 to 15-6 
DRAW command, 11-20 

DRAW ARC command, 11-28 

DRAW CIRCLE command, 11-29 


encoding, see coordinate encoding 

END CHARACTER DEFINITION command, 15-10 
END MACRO DEFINITION command, 14-6 

error codes, 1-12, J-1 to J-3 

error, fatal, J-3 

error, nonfatal, J-1, J-2 

EXPAND MACRO command, 14-7 


font, see SELECT STANDARD ALPHA FONT and 
SELECT ALTERNATE ALPHA FONT commands 
format, see Command/Response Format 


GDU, see Graphic Device Unit 

GPIB connector, E-1 

GPIB data bus, E-3 

GPIB digitizing, see digitizing 

GPIB management bus, E-3 

GPIB transfer bus, E-3 

Graph mode, 4-40 

Graphic Device Unit, 1-3, 1-8, 1-12 

Graphic Unit, see SELECT GRAPHIC UNITS command 


Hardware Receive mode, 4-15 
hardware receive flagging, 4-15, 4-21 
home position, 10-2 

host connection, 4-1 


IDENTIFY command, 9-11 

initial aspect ratio, 1-8 

Initial Command/Response Format, 4-7, 5-3 

Initial Page Size, 1-5 

Initial Viewport, 1-8 

Initial Window, 1-9, 1-10 

input buffering, 4-17, 4-18, 5-10, 5-11 

input character buffer, 4-18 

input command buffer, 4-18, 4-20 

input rate control, 4-20 

installed Options, 9-8 

Interface Clear (IFC), 5-14 

interface functions (GPIB), 5-6 

interface functions (Serial), 4-12 

INTERFACE PARAMETER RESET command, 7-11, 8-4 

Interface Select line, 4-7, 5-3 

Interface Switching function, 4-16, 5-7 

internal expansion factor, 4-19, 5-11 

interpretation of commands, see command 
interpretation 
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JOYSTICK AXIS DISABLE command, 13-16 


line type, 1-11, 11-2, see also SELECT LINE TYPE 
command 

listener, 5-8, E-2 

loop-thru connection, 4-3, 4-17 


macro, 14-1 to 14-3 

margin control, 10-8 

MARK VIEWPORT commana, 11-24 
media change, 16-1 

memory, see available memory 
millimeters (Device Unit), 1-3, 1-8, 1-9, 1-10 
MLA (My Listen Address), 5-8 

MOVE command, 11-18 

MOVE TO HOME command, 10-25 
MOVE TO LOAD POINT command, 11-22 
MSA (My Secondary Address), 5-8, 5-27 
MTA (My Talk Address), 5-12 

multiple plotters, 4-5, 4-32 


notation, see conventions 
null arguments, 4-37, 5-20 
numeric argument, 4-19, 4-34, 5-18 


offline local, 4-16, 5-7 

offline remote, 4-16, 5-7 

online local, 4-16, 5-7 

online remote, 4-16, 5-7 

OPERATOR DIGITIZE ENABLE command, 13-10 
optional arguments, 4-37, 5-21 
options, see installed options 
OUTLINE VIEWPORT command, 11-23 
output blocks, 4-27 to 4-32 

output buffering, 4-29, 5-12 

output initialize, 4-30 

output messages, 4-29 

output rate control, 4-31 

output responses, 4-48, 5-21 

output terminator, 4-13 
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Page, 1-3, 1-5 

PAGE CHANGE command, 16-2 
page scaling, 1-12 

Parameter Entry Card, 4-7, 5-3 

pen carriage, 1-5 

pen status, 9-8 

platen, 1-3, 1-5 

platen clipping boundary, 1-11 

plot time, see accumulated plot time 
plotter connections, 4-1, 4-3, 4-4 
Point Plot mode, 4-45 

primary address, 6-7 

PRINT command, 10-2, 10-7, 10-8, 10-22 


c 
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PRINT CENTERED command, 10-24 
PROMPT LIGHT OFF command, 13-15 
PROMPT LIGHT ON command, 13-14 
Prompt function, 4-30 


READ ERROR command, 9-9 

READ FORM LENGTH command, 16-4 

READ MACRO STATUS command, 14-9 

READ STATUS command, 9-4 

READ VIEWPORT command, 11-26 

receive baud rate, 4-10 

receive parity, 4-11 

reprocessed command terminator, 4-36 

RESET ALPHA PARAMETER command, 10-21 

resident alpha fonts, 10-4 

resolution, 1-12, 4-44 

response block, 4-49 

RESTORE PREVIOUS TRANSFORM command, 
12-4,12-13 

rotation, see SET ROTATION command 

RS-232-C Lines, 4-17 


SAVE CURRENT TRANSFORM command, 12-4, 12-12 

secondary address, 6-7, see also MSA 

SELECT ALPHA SPACING CONTROL command, 10-18 

SELECT ALTERNATE ALPHA FONT command, 10-20 

SELECT CLIPPING CONTROL command, 11-14 

SELECT COMMAND/RESPONSE FORMAT command, 
4-7, 7-13, 8-3 

SELECT COORDINATE TYPE command, 1-11, 11-13 

SELECT DEVICE UNITS command, 11-9, see also 
Device Units 

SELECT GRAPHIC UNITS command, 1-11, 11-8 

SELECT LINE TYPE command, 1-11, 11-15 

SELECT NONADVANCING CHARACTER command, 
15-12 

SELECT PEN command, 11-12 

SELECT STANDARD ALPHA FONT command, 10-19 

selected device clear, 5-14 

serial device address, 4-10 

serial poll, 5-15 

Service Request (SRQ), 5-15 

SET ALPHA DIMENSION command, 10-12 

SET ALPHA MARGIN SEPARATION command, 
10-17 

SET ALPHA RATIO command, 10-11 

SET ALPHA ROTATION command, 10-13 

SET ALPHA SCALE command, 10-15 

SET ALPHA SIZE command, 10-9 

SET ALPHA SLANT command, 10-14 

SET ARC SMOOTHNESS command, 11-27 

SET AUTO MACRO command, 14-11 

SET BLOCK SIZE command, 7-7 

SET BYPASS CANCEL CHARACTER command, 7-8 

SET CHARACTER X-EXTENT command, 15-11 


4663 PROGRAMMER’S REFERENCE 


INDEX 


SET DASH PATTERN command, 11-16 

SET DASH PATTERN LENGTH command, 11-17 

SET DOWNLOADED CHARACTER SIZE command, 
15-8 

SET FORM LENGTH command, 16-3 

SET ORIGIN TO CURRENT POSITION command, 
12-1, 12-10 

SET PROMPT STRING command, 7-10 

SET ROTATION command, 12-9 

SET ROTATION TO LAST ANGLE command, 
42-2, 12-11 

SET SCALE command, 12-1, 12-6 

SET SIGNATURE CHARACTER command, 7-9 

SET SKEW command, 12-1, 12-8 

SET TAB SEPARATION command, 10-16 

SET TRANSLATION command, 12-1, 12-7 

SET TURNAROUND DELAY command, 7-6 

SET VIEWPORT command, 11-10 

SET WINDOW command, 1-7, 11-11 

SDC, see selected device clear 

SIZE command, 9-13 

skew, see SET SKEW command 

smoothness, see SET ARC SMOOTHNESS command 

SRQ, see service request 

standard alpha font, see SELECT STANDARD ALPHA 
FONT command 

string arguments, 4-19, 4-34, 4-35, 5-19 

storage requirements, 4-19 

Style | commands, 4-19, 4-33, 4-48 

Style Il commands, 4-19, 4-33, 4-38, 4-48 

syntax, see command syntax 


TAG value, 4-28 

talk address, see MTA 

talker, 5-12, E-2 

terminal connection, 4-4 

terminator, see command terminator 
transformation commands, 1-10, 12-1 
transmit baud rate, 4-10, 4-31 
transmit baud rate limit, 4-10 
transmit parity, 4-11 

Turnaround Delay function, 4-30 


undelimited string, 4-35, 5-19 
unlisten (UNL), 5-8 

untalk (UNT), 5-8 

user domain, 1-9 


Viewport, 1-3, 1-8, see also SET VIEWPORT and READ 
VIEWPORT commands 
viewport scaling, 1-12 


Window, 1-3, 1-9, see also SET WINDOW command 
World Space, 1-3, 1-9 
World Units, 1-3, 1-9, 1-12 
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